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


Функция PTOpenProvider (prntvpt.h)

Открывает экземпляр поставщика билетов на печать.

Синтаксис

HRESULT PTOpenProvider(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwVersion,
  [out] HPTPROVIDER *phProvider
);

Параметры

[in] pszPrinterName

Указатель на полное имя очереди печати.

dwVersion

Версия схемы печати , запрошенная вызывающим элементом.

[out] phProvider

Указатель на дескриптор для поставщика.

Возвращаемое значение

Если операция выполнена успешно, возвращаемое значение S_OK, в противном случае HRESULT содержит код ошибки.

Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок.

Комментарии

Примечание Это блокирующая или синхронная функция, возвращаемая не сразу. Скорость возврата этой функции зависит от факторов времени выполнения, таких как состояние сети, конфигурация сервера печати и реализация драйвера принтера, которые трудно предсказать при написании приложения. Вызов этой функции из потока, который управляет взаимодействием с пользовательским интерфейсом, может привести к тому, что приложение не отвечает.
 
PszPrinterName должно быть полным именем, а не усеченным именем, как это может появиться в DEVMODE.

Первая версия схемы печати была выпущена в Windows Vista и является версией 1. Эта операция завершается сбоем , если версия не поддерживается. Сравните это с PTOpenProviderEx , который открывает поставщик, даже если он поддерживает только версии, предшествующие запрошенной.

Чтобы избежать утечки ресурсов, необходимо закрыть phProvider с помощью PTCloseProvider.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header prntvpt.h
Библиотека Prntvpt.lib
DLL Prntvpt.dll

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

Схема печати

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

Вывод на печать