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