Função SetAbortProc (wingdi.h)

Artigo
03/13/2024

A função SetAbortProc define a função de anulação definida pelo aplicativo que permite que um trabalho de impressão seja cancelado durante o spooling.

Sintaxe

int SetAbortProc(
  [in] HDC       hdc,
  [in] ABORTPROC proc
);

Parâmetros

[in] hdc

Manipule para o contexto do dispositivo para o trabalho de impressão.

[in] proc

Ponteiro para a função de anulação definida pelo aplicativo. Para obter mais informações sobre a função de retorno de chamada, consulte a função de retorno de chamada AbortProc .

Retornar valor

Se a função obtiver êxito, o valor retornado será maior que zero.

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

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 do 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.

Exemplos

Para obter um exemplo, consulte Como coletar informações de trabalho de impressão do usuário.

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)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll