Função GetSpoolFileHandle

A função GetSpoolFileHandle recupera um identificador para o arquivo de spool associado ao trabalho enviado atualmente pelo aplicativo.

Sintaxe

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

Parâmetros

hPrinter [in]

Um identificador para a impressora para a qual o trabalho foi enviado. Esse deve ser o mesmo identificador usado para enviar o trabalho. (Use a função OpenPrinter ou AddPrinter para recuperar um identificador de impressora.)

Valor retornado

Se a função for bem-sucedida, ela retornará um identificador para o arquivo de spool.

Se a função falhar, ela retornará INVALID_HANDLE_VALUE.

Comentários

Com o identificador para o arquivo de spool, seu aplicativo pode gravar no arquivo de spool com chamadas para WriteFile seguidas por CommitSpoolData.

Seu aplicativo não deve chamar ClosePrinter no hPrinter até que ele tenha acessado o arquivo de spool pela última vez. Em seguida, ele deve chamar CloseSpoolFileHandle seguido por ClosePrinter. As tentativas de acessar o identificador de arquivo de spool depois que o hPrinter original tiver sido fechado falharão mesmo que o próprio identificador de arquivo não tenha sido fechado. CloseSpoolFileHandle falhará se ClosePrinter for chamado primeiro.

Essa função falhará se for chamada antes da conclusão do spool do trabalho de impressão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	Winspool.h (inclua Windows.h)
Biblioteca	Winspool.lib
DLL	WinSpool.drv
Nomes Unicode e ANSI	GetSpoolFileHandleW (Unicode) e GetSpoolFileHandleA (ANSI)

Confira também

Impressão

Funções da API do Spooler de impressão

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData