Share via


Função CloseSpoolFileHandle

A função CloseSpoolFileHandle fecha um identificador para um arquivo de spool associado ao trabalho de impressão enviado atualmente pelo aplicativo.

Sintaxe

BOOL CloseSpoolFileHandle(
  _In_ HANDLE hPrinter,
  _In_ HANDLE hSpoolFile
);

Parâmetros

hPrinter [in]

Um identificador para a impressora para a qual o trabalho foi enviado. Esse deve ser o mesmo identificador usado para obter hSpoolFile com GetSpoolFileHandle.

hSpoolFile [in]

Um identificador para o arquivo de spool que está sendo fechado. Se CommitSpoolData não tiver sido chamado desde que GetSpoolFileHandle foi chamado, esse deverá ser o mesmo identificador retornado por GetSpoolFileHandle. Caso contrário, ele deve ser o identificador que foi retornado pela chamada mais recente para CommitSpoolData.

Valor retornado

TRUE, se for bem-sucedido, false caso contrário.

Comentários

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.

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

Confira também

Impressão

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

ClosePrinter

GetSpoolFileHandle