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 estructuraDEVMODEW. 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.
Observaciones
La función GdiGetSpoolFileHandle se exporta mediante gdi32.dll para su uso en 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 estructuraPRINTPROCESSOROPENDATA, 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 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | winppi.h (incluya Winppi.h) |
| biblioteca de | Gdi32.Lib |
| DLL de | Gdi32.dll |