Share via


Función CloseSpoolFileHandle

La función CloseSpoolFileHandle cierra un identificador de un archivo de cola asociado al trabajo de impresión enviado actualmente por la aplicación.

Sintaxis

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

Parámetros

hPrinter [in]

Identificador de la impresora a la que se envió el trabajo. Debe ser el mismo identificador que se usó para obtener hSpoolFile con GetSpoolFileHandle.

hSpoolFile [in]

Identificador del archivo de cola que se está cerrando. Si no se ha llamado a CommitSpoolData desde que se llamó a GetSpoolFileHandle , debería ser el mismo identificador devuelto por GetSpoolFileHandle. De lo contrario, debe ser el identificador devuelto por la llamada más reciente a CommitSpoolData.

Valor devuelto

TRUE, si se realiza correctamente, FALSE en caso contrario.

Comentarios

La aplicación no debe llamar a ClosePrinter en hPrinter hasta que haya accedido al archivo de cola por última vez. A continuación, debe llamar a CloseSpoolFileHandle seguido de ClosePrinter. Se producirá un error en los intentos de acceso al identificador de archivo de cola después de que se haya cerrado el hPrinter original, incluso si el propio identificador de archivo no se ha cerrado. CloseSpoolFileHandle producirá un error si se llama primero a ClosePrinter .

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado
Winspool.h (incluye Windows.h)
Biblioteca
Winspool.lib
Archivo DLL
WinSpool.drv

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

ClosePrinter

GetSpoolFileHandle