Функция DeletePrinterDriverPackage

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

Синтаксис

HRESULT DeletePrinterDriverPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszEnvironment
);

Параметры

pszServer [in]

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

pszInfPath [in]

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

pszEnvironment [in]

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

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

S_OK, если операция выполнена успешно.

E_ACCESSDENIED, если пакет был отправлен вместе с Windows.

HRESULT_CODE (ERROR_PRINT_DRIVER_PACKAGE_IN_USE), если пакет используется.

В противном случае HRESULT будет содержать код ошибки.

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

Комментарии

Примечание

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

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

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

Пользователь должен иметь права администрирования принтера.

Требования

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

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

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

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