CancelDC

Declare Function Api_CancelDC& Lib "gdi32" Alias "CancelDC" (ByVal hDC&)

Declare Function CancelDC Lib "gdi32" Alias "CancelDC" (ByVal hdc As Long) As Long

指定されたデバイスコンテキストの未処理の操作をすべて取り消す。

パラメータ
hdc
    デバイスコンテキストのハンドルを指定する。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000：拡張エラー情報を取得するには、 関数を使う。

解説
    マルチスレッドアプリケーションでは、CancelDC 関数を使って、時間のかかる描画操作を取り消すことができる。たとえば、スレッド A が時

    間のかかる描画操作を行っている最中に、スレッド B が CancelDC 関数を呼び出すと、その描画操作が取り消される。
    描画操作を取り消すと、影響を受けたスレッドの側ではエラーが発生し、その描画操作の結果は未定義になる。描画操作が行われていな

    い状況でこの関数を呼び出した場合も、結果は未定義になる。