Функция InstallPrinterDriverFromPackage

Устанавливает драйвер принтера из пакета драйверов, который находится в хранилище драйверов сервера печати.

Синтаксис

HRESULT InstallPrinterDriverFromPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszDriverName,
  _In_ LPCTSTR pszEnvironment,
  _In_ DWORD   dwFlags
);

Параметры

pszServer [in]

Указатель на константную строку, завершающуюся значением NULL, которая указывает имя сервера печати. NULL означает локальный компьютер.

pszInfPath [in]

Указатель на константную строку со значением NULL, которая указывает путь к хранилищу драйверов к INF-файлу драйвера печати. ЗНАЧЕНИЕ NULL означает, что драйвер находится в INF-файле, поставляемом вместе с Windows.

pszDriverName [in]

Указатель на константную строку, завершающуюся значением NULL, которая указывает имя драйвера.

pszEnvironment [in]

Указатель на константную строку, завершающуюся значением NULL, которая указывает архитектуру процессора (например, Windows NT x86). Может иметь значение NULL.

dwFlags [in]

Это значение может быть только 0 или IPDFP_COPY_ALL_FILES. Значение 0 означает, что необходимо добавить драйвер принтера и скопировать все файлы в каталоге драйвера принтера, которые являются более новыми, чем соответствующие файлы, используемые в настоящее время. Значение IPDFP_COPY_ALL_FILES означает, что необходимо добавить драйвер принтера и все файлы в каталоге драйвера принтера. Метки времени файла игнорируются, если dwFlags имеет значение IPDFP_COPY_ALL_FILES.

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

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

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

Комментарии

Примечание

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

Хранилищем драйверов обычно является %windir%\inf или %windir%\System32\DriverStore\FileRepository.

InstallPrinterDriverFromPackage также устанавливает другие файлы в пакете, такие как цветовые профили и процессоры печати.

Пользователи должны иметь права администрирования принтера для установки на удаленном компьютере или на локальном компьютере, когда пользователь вошел с помощью служб терминалов.

На удаленном компьютере можно установить только подписанные пакеты.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Winspool.h (включая Windows.h)
Библиотека	Winspool.lib
DLL	Spoolss.dll
Имя в кодировке Юникод и ANSI	InstallPrinterDriverFromPackageW (Юникод) и InstallPrinterDriverFromPackageA (ANSI)

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

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

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