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

See also

CreateThread

Device Context Functions

Device Contexts Overview

GetCurrentThread