Función GdiGetSpoolFileHandle (winppi.h)

La función GdiGetSpoolFileHandle devuelve un identificador al archivo EMF de un trabajo de impresión.

Sintaxis

HANDLE GdiGetSpoolFileHandle(
  LPWSTR     pwszPrinterName,
  LPDEVMODEW pDevmode,
  LPWSTR     pwszDocName
);

Parámetros

pwszPrinterName

Puntero proporcionado por el autor de la llamada a una cadena que representa el nombre de la impresora de destino. Consulte la siguiente sección Comentarios.

pDevmode

Puntero proporcionado por el autor de la llamada a una estructura DEVMODEW . Consulte la siguiente sección Comentarios.

pwszDocName

Puntero proporcionado por el autor de la llamada al nombre del documento del trabajo de impresión. Consulte la siguiente sección Comentarios.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve un identificador de archivo de cola. De lo contrario, la función devuelve NULL.

Comentarios

La función GdiGetSpoolFileHandle se exporta mediante gdi32.dll para su uso dentro de la función PrintDocumentOnPrintProcessor de un procesador de impresión.

Cuando un procesador de impresión llama a GdiGetSpoolFileHandle, debe proporcionar argumentos como se muestra en la tabla siguiente.

Parámetro	Argumento
pwszPrinterName	Puntero al nombre de la impresora recibido por la función OpenPrintProcessor del procesador de impresión.
pDevmode	Puntero a la estructura DEVMODEW contenida en la estructura PRINTPROCESSOROPENDATA , recibida por la función OpenPrintProcessor del procesador de impresión.
pwszDocName	Puntero de nombre de documento recibido por la función PrintDocumentOnPrintProcessor del procesador de impresión.

Un procesador de impresión debe llamar a la función GdiGetSpoolFileHandle antes de llamar a cualquier otra función de impresión de GDI, ya que el identificador devuelto debe pasarse a las demás funciones. La función llama a OpenPrinter para abrir una conexión a la impresora y CreateDC para crear un contexto de dispositivo para dibujar. El procesador de impresión puede obtener el identificador del contexto del dispositivo llamando a GdiGetDC.

Para obtener más información, consulte Uso de funciones GDI en procesadores de impresión.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	winppi.h (incluir Winppi.h)
Library	Gdi32.Lib
Archivo DLL	Gdi32.dll

Consulte también

GdiDeleteSpoolFileHandle