Compartilhar via


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

Confira também

CreateThread

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

GetCurrentThread