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

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

  • Статья

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

Синтаксис

HRESULT PTOpenProviderEx(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwMaxVersion,
        DWORD       dwPrefVersion,
  [out] HPTPROVIDER *phProvider,
  [out] DWORD       *pUsedVersion
);

Параметры

[in] pszPrinterName

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

dwMaxVersion

Последняя версия схемы печати , которую поддерживает вызывающий объект.

dwPrefVersion

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

[out] phProvider

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

[out] pUsedVersion

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

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

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

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

Комментарии

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

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

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

Требования

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

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

Схема печати

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

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