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


Функции API очереди печати принтера

API очереди печати содержит функции и структуры данных, используемые приложениями для управления очередью печати Windows, а также принтерами и заданиями печати, которыми он управляет.

Функции API очереди печати делятся на следующие группы:

Эти функции отправляют задания печати на принтер, а также отслеживают задания печати и управляют ими в очереди печати.

Функция Описание
AddJob
Функция AddJob добавляет задание печати в список заданий печати, которые могут быть запланированы диспетчером очереди печати. Функция извлекает имя файла, который можно использовать для хранения задания.
ClosePrinter
Функция ClosePrinter закрывает указанный объект принтера.
DocumentEvent
Функция DocumentEvent — это обработчик событий, связанных с печатью документа.
DocumentProperties
Функция DocumentProperties извлекает или изменяет сведения об инициализации принтера или отображает страницу свойств конфигурации принтера для указанного принтера.
EndDocPrinter
Функция EndDocPrinter завершает задание печати для указанного принтера.
EndPagePrinter
Функция EndPagePrinter уведомляет диспетчер очереди печати о том, что приложение находится в конце страницы в задании печати.
Задания перечисления
Функция EnumJobs извлекает сведения об указанном наборе заданий печати для указанного принтера.
GetJob
Функция GetJob извлекает сведения об указанном задании печати.
OpenPrinter
Функция OpenPrinter извлекает дескриптор указанного принтера или сервера печати или других типов дескрипторов в подсистеме печати.
OpenPrinter2
Извлекает дескриптор указанного принтера, сервера печати или других типов дескрипторов в подсистеме печати, задавая при этом некоторые параметры принтера.
ReportJobProcessingProgress
Сообщает службе очереди печати печати, указывает, находится ли задание печати XPS на этапе spooling или подготовки к просмотру и какая часть обработки выполняется в данный момент.
ScheduleJob
Функция ScheduleJob запрашивает, чтобы очередь печати запланировыла указанное задание печати для печати.
SetJob
Функция SetJob приостанавливает, возобновляет, отменяет или перезапускает задание печати на указанном принтере. Вы также можете использовать функцию SetJob для задания параметров задания печати, таких как приоритет задания печати и имя документа.
StartDocPrinter
Функция StartDocPrinter уведомляет диспетчер очереди печати о том, что документ должен быть распечатыван для печати.
StartPagePrinter
Функция StartPagePrinter уведомляет диспетчер очереди о том, что страница будет напечатана на указанном принтере.

Функции пользовательского интерфейса принтера

Эти функции отображают пользовательский интерфейс, позволяющий пользователю выбрать или настроить принтер.

Функция Описание
AdvancedDocumentProperties
Функция AdvancedDocumentProperties отображает диалоговое окно конфигурации принтера для указанного принтера, позволяющее пользователю настроить этот принтер.
Настройка порта
Функция ConfigurePort отображает диалоговое окно настройки порта для порта на указанном сервере.
ConnectToPrinterDlg
Функция ConnectToPrinterDlg отображает диалоговое окно, позволяющее пользователям просматривать принтеры в сети и подключаться к нему. Если пользователь выбирает принтер, функция пытается создать к нему подключение; Если подходящий драйвер не установлен на сервере, пользователю предоставляется возможность локального создания принтера.
Свойства PrinterProperties
Функция PrinterProperties отображает страницу свойств принтера для указанного принтера.

Функции принтера

Эти функции добавляют и настраивают принтеры, используемые диспетчером очереди печати.

Функция Описание
AbortPrinter
Функция AbortPrinter удаляет файл очереди принтера, если принтер настроен для очереди.
AddPrinter
Функция AddPrinter добавляет принтер в список поддерживаемых принтеров для указанного сервера.
AddPrinterConnection
Функция AddPrinterConnection добавляет подключение к указанному принтеру для текущего пользователя.
AddPrinterConnection2
Добавляет подключение к указанному принтеру для текущего пользователя и указывает сведения о подключении.
DeletePrinter
Функция DeletePrinter удаляет указанный объект принтера.
DeletePrinterConnection
Функция DeletePrinterConnection удаляет подключение к принтеру, которое было установлено путем вызова Метода AddPrinterConnection или ConnectToPrinterDlg.
DeletePrinterData
Функция DeletePrinterData удаляет указанные данные конфигурации для принтера. Данные конфигурации принтера состоят из набора именованных и типизированных значений. Функция DeletePrinterData удаляет одно из этих значений, указанное именем значения.
DeletePrinterDataEx
Функция DeletePrinterDataEx удаляет указанное значение из данных конфигурации принтера. Данные конфигурации принтера состоят из набора именованных и типизированных значений, хранящихся в иерархии разделов реестра. Функция удаляет указанное значение в указанном ключе.
DeletePrinterKey
Функция DeletePrinterKey удаляет указанный ключ и все его подразделы для указанного принтера.
EnumPrinterData
Функция EnumPrinterData перечисляет данные конфигурации для указанного принтера.
EnumPrinterDataEx
Функция EnumPrinterDataEx перечисляет все имена значений и данные для указанного принтера и ключа.
EnumPrinterKey
Функция EnumPrinterKey перечисляет подразделы указанного ключа для указанного принтера.
EnumPrinters
Функция EnumPrinters перечисляет доступные принтеры, серверы печати, домены или поставщики печати.
FlushPrinter
Функция FlushPrinter отправляет буфер принтеру, чтобы очистить его от временного состояния.
GetDefaultPrinter
Функция GetDefaultPrinter извлекает имя принтера по умолчанию для текущего пользователя на локальном компьютере.
GetPrinter
Функция GetPrinter извлекает сведения об указанном принтере.
GetPrinterData
Функция GetPrinterData извлекает данные конфигурации для указанного принтера или сервера печати.
GetPrinterDataEx
Функция GetPrinterDataEx извлекает данные конфигурации для указанного принтера или сервера печати. GetPrinterDataEx может извлекать значения, хранящиеся функцией SetPrinterData . Кроме того, GetPrinterDataEx может извлекать значения, хранящиеся в указанном ключе с помощью функции SetPrinterDataEx .
IsValidDevmode
Функция IsValidDevmode проверяет допустимость содержимого структуры DEVMODE.
ReadPrinter
Функция ReadPrinter извлекает данные из указанного принтера.
ResetPrinter
Функция ResetPrinter указывает тип данных и значения режима устройства, которые будут использоваться для печати документов, отправленных функцией StartDocPrinter . Эти значения можно переопределить с помощью функции SetJob после начала печати документов.
SetDefaultPrinter
Функция SetDefaultPrinter задает имя принтера по умолчанию для текущего пользователя на локальном компьютере.
SetPort
Функция SetPort задает состояние, связанное с портом принтера.
SetPrinter
Функция SetPrinter задает данные для указанного принтера или задает состояние указанного принтера путем приостановки печати, возобновления печати или очистки всех заданий печати.
SetPrinterData
Функция SetPrinterData задает данные конфигурации для принтера или сервера печати.
SetPrinterDataEx
Функция SetPrinterDataEx задает данные конфигурации для принтера или сервера печати. Функция сохраняет данные конфигурации в разделе реестра принтера.
WritePrinter
Функция WritePrinter уведомляет диспетчер очереди печати печати о том, что данные должны быть записаны на указанный принтер.

Функции уведомления об изменении принтера

Эти функции позволяют приложению получать уведомления об изменениях в состоянии принтера.

Функция Описание
FindClosePrinterChangeNotification
Функция FindClosePrinterChangeNotification закрывает объект уведомления об изменениях, созданный путем вызова функции FindFirstPrinterChangeNotification . Принтер или сервер печати, связанные с объектом уведомления об изменениях, больше не будут отслеживаться этим объектом.
FindFirstPrinterChangeNotification
Функция FindFirstPrinterChangeNotification создает объект уведомления об изменениях и возвращает дескриптор объекту . Затем этот дескриптор можно использовать в вызове одной из функций ожидания для отслеживания изменений на принтере или сервере печати.
FindNextPrinterChangeNotification
Функция FindNextPrinterChangeNotification извлекает сведения о последнем уведомлении об изменениях для объекта уведомления об изменениях, связанного с принтером или сервером печати. Вызывайте эту функцию, когда выполняется операция ожидания объекта уведомления об изменениях.
FreePrinterNotifyInfo
Функция FreePrinterNotifyInfo освобождает буфер, выделенный системой, созданный функцией FindNextPrinterChangeNotification .

Функции формы принтера

Эти функции управляют формами, используемыми принтером.

Функция Описание
AddForm
Функция AddForm добавляет форму в список доступных форм, которые можно выбрать для указанного принтера.
DeleteForm
Функция DeleteForm удаляет имя формы из списка поддерживаемых форм.
EnumForms
Функция EnumForms перечисляет формы, поддерживаемые указанным принтером.
GetForm
Функция GetForm извлекает сведения об указанной форме.
SetForm
Функция SetForm задает сведения о форме для указанного принтера.

Эти функции взаимодействуют с очередью печати печати на низком уровне.

Функция Описание
CloseSpoolFileHandle
Функция CloseSpoolFileHandle закрывает дескриптор в файл очереди, связанный с заданием печати, отправленным приложением.
CommitSpoolData
Функция CommitSpoolData уведомляет диспетчер очереди печати печати о том, что указанный объем данных был записан в указанный файл очереди и готов к просмотру.
GetPrintExecutionData
GetPrintExecutionData извлекает текущий контекст печати.
GetSpoolFileHandle
Функция GetSpoolFileHandle извлекает дескриптор для файла очереди, связанного с заданием, которое в настоящее время отправлено приложением.