Prev Next

CancelDC info  Overview  Group

The CancelDC function cancels any pending operation on the specified device context (DC).

BOOL CancelDC(

    HDC hdc 

// handle to device context

   );

Parameters

hdc
Identifies the DC.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The CancelDC function is used by multithreaded applications to cancel lengthy drawing operations. If thread A initiates a lengthy drawing operation, thread B may cancel that operation by calling this function.

If an operation is canceled, the affected thread returns an error and the result of its drawing operation is undefined. The results are also undefined if no drawing operation was in progress when the function was called.

See Also

CreateThread, GetCurrentThread