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 ejecuta correctamente, devuelve un identificador al archivo de cola.
Si se produce un error en la función, devuelve INVALID_HANDLE_VALUE.
Observaciones
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. 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 .
Esta función producirá un error si se llama antes de que el trabajo de impresión haya terminado de colarse.
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) |