Função de retorno de chamada ABORTPROC (wingdi.h)

Artigo
08/27/2023

A função AbortProc é uma função de retorno de chamada definida pelo aplicativo usada com a função SetAbortProc . Ele é chamado quando um trabalho de impressão deve ser cancelado durante o spool. O tipo ABORTPROC define um ponteiro para essa função de retorno de chamada. AbortProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

ABORTPROC Abortproc;

BOOL Abortproc(
  HDC unnamedParam1,
  int unnamedParam2
)
{...}

Parâmetros

unnamedParam1

unnamedParam2

Valor retornado

A função de retorno de chamada deve retornar TRUE para continuar o trabalho de impressão ou FALSE para cancelar o trabalho de impressão.

Comentários

Nota Essa é uma função de bloqueio ou síncrona e pode não retornar imediatamente. A rapidez com que essa função retorna depende de fatores de tempo de execução, como status de rede, configuração do servidor de impressão e implementação de driver de impressora, fatores difíceis de prever ao escrever um aplicativo. Chamar essa função de um thread que gerencia a interação com a interface do usuário pode fazer com que o aplicativo pareça não responder.

Se o parâmetro iError for SP_OUTOFDISK, o aplicativo não precisará cancelar o trabalho de impressão. Se ele não cancelar o trabalho, ele deverá ser gerado para o Gerenciador de Impressão chamando a função PeekMessage ou GetMessage .

Requisitos

Requisito	Valor
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)