Función GetSpoolFileHandle
La función GetSpoolFileHandle recupera un identificador para el archivo de cola asociado al trabajo enviado actualmente por la aplicación.
Sintaxis
HANDLE GetSpoolFileHandle(
_In_ HANDLE hPrinter
);
Parámetros
-
hPrinter [in]
-
Identificador de la impresora a la que se envió el trabajo. Debe ser el mismo identificador que se usó para enviar el trabajo. (Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora).
Valor devuelto
Si la función se realiza correctamente, devuelve un identificador al archivo de cola.
Si se produce un error en la función, devuelve INVALID_HANDLE_VALUE.
Comentarios
Con el identificador del archivo de cola, la aplicación puede escribir en el archivo de cola con llamadas a WriteFile seguido de CommitSpoolData.
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. Los intentos de acceder al identificador de archivo de cola después de cerrar hPrinter original producirán un error incluso si el propio identificador de archivo no se ha cerrado. CloseSpoolFileHandle producirá un error si se llama primero a ClosePrinter .
Esta función producirá un error si se llama antes de que el trabajo de impresión haya terminado de crear colas.
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 |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
GetSpoolFileHandleW (Unicode) y GetSpoolFileHandleA (ANSI) |