Функция GetCorePrinterDrivers

Извлекает GUID, версию и дату указанных основных драйверов принтера и путь к их пакетам.

Синтаксис

HRESULT GetCorePrinterDrivers(
  _In_  LPCTSTR              pszServer,
  _In_  LPCTSTR              pszEnvironment,
  _In_  LPCTSTR              pszzCoreDriverDependencies,
  _In_  DWORD                cCorePrinterDrivers,
  _Out_ PCORE_PRINTER_DRIVER pCorePrinterDrivers
);

Параметры

pszServer [in]

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

pszEnvironment [in]

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

pszzCoreDriverDependencies [in]

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

cCorePrinterDrivers [вход]

Количество строк в pszzCoreDriverDependencies.

pCorePrinterDrivers [out]

Указатель на массив из одной или нескольких CORE_PRINTER_DRIVER структур.

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

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

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

Комментарии

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

Требования

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

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

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

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