Функция GdiGetSpoolFileHandle (winppi.h)
Функция GdiGetSpoolFileHandle возвращает дескриптор в EMF-файл задания печати.
Синтаксис
HANDLE GdiGetSpoolFileHandle(
LPWSTR pwszPrinterName,
LPDEVMODEW pDevmode,
LPWSTR pwszDocName
);
Параметры
pwszPrinterName
Указатель, предоставленный вызывающим объектом, на строку, представляющую имя целевого принтера. См. следующий раздел "Примечания".
pDevmode
Вызывающий указатель на структуруDEVMODEW. См. следующий раздел "Примечания".
pwszDocName
Вызывающий указатель на имя документа задания печати. См. следующий раздел "Примечания".
Возвращаемое значение
Если операция выполнена успешно, функция возвращает дескриптор файла спулом. В противном случае функция возвращает NULL.
Замечания
Функция GdiGetSpoolFileHandle экспортируется gdi32.dll для использования в функции PrintDocumentOnPrintProcess or.
Когда обработчик печати вызывает GdiGetSpoolFileHandle, он должен предоставлять аргументы, как показано в следующей таблице.
| Параметр | Аргумент |
|---|---|
| pwszPrinterName | Указатель на имя принтера, полученное функцией OpenPrintProcess or обработчика печати. |
| pDevmode | Указатель на структуру DEVMODEW, содержащуюся в структуре printPROCESSOROPENDATA, полученной функции OpenPrintProcessor обработчика печати. |
| pwszDocName | Указатель имени документа, полученный функции PrintDocumentOnPrintProcessor обработчика печати. |
Обработчик печати должен вызывать функцию GdiGetSpoolFileHandle перед вызовом других функций печати GDI, так как возвращенный дескриптор должен передаваться другим функциям. Функция вызывает OpenPrinter, чтобы открыть подключение к принтеру и CreateDC, чтобы создать контекст устройства для рисования. Обработчик печати может получить дескриптор контекста устройства, вызвав GdiGetDC.
Дополнительные сведения см. в разделе Использование функций GDI впроцессоров печати.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | winppi.h (include Winppi.h) |
| библиотеки | Gdi32.Lib |
| DLL | Gdi32.dll |