Поделиться через

Функция 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

См. также раздел

GdiDeleteSpoolFileHandle