CancelDC function

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

Syntax


BOOL CancelDC(
  _In_ HDC hdc
);

Parameters

hdc [in]

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Device Contexts Overview
Device Context Functions
CreateThread
GetCurrentThread

 

 

Show: