CancelDC function (wingdi.h)
The CancelDC function cancels any pending operation on the specified device context (DC).
Syntax
BOOL CancelDC(
[in] HDC hdc
);
Parameters
[in] hdc
A handle to the DC.
Return value
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
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.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | wingdi.h (include Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |