Função CancelDC (wingdi.h)

A função CancelDC cancela qualquer operação pendente no DC (contexto de dispositivo) especificado.

Sintaxe

BOOL CancelDC(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para o controlador de domínio.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A função CancelDC é usada por aplicativos multithreaded para cancelar longas operações de desenho. Se o thread A iniciar uma operação de desenho longa, o thread B poderá cancelar essa operação chamando essa função.

Se uma operação for cancelada, o thread afetado retornará um erro e o resultado de sua operação de desenho será indefinido. Os resultados também serão indefinidos se nenhuma operação de desenho estiver em andamento quando a função foi chamada.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll