Share via

структура PRINTER_INFO_7

  • Статья

Структура PRINTER_INFO_7 указывает сведения о принтере служб каталогов. Используйте эту структуру с функцией SetPrinter для публикации данных принтера в службе каталогов (DS), а также для обновления или удаления опубликованных данных принтера из DS. Используйте эту структуру с функцией GetPrinter , чтобы определить, публикуется ли принтер в DS.

Синтаксис

typedef struct _PRINTER_INFO_7 {
  LPTSTR pszObjectGUID;
  DWORD  dwAction;
} PRINTER_INFO_7, *PPRINTER_INFO_7;

Члены

pszObjectGUID

Указатель на строку со значением NULL, содержащую GUID объекта очереди печати службы каталогов, связанного с опубликованным принтером. Используйте функцию GetPrinter для получения этого GUID.

Перед вызовом SetPrinter задайте для параметра pszObjectGUIDзначение NULL.

dwAction

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

Значение Значение
DSPRINT_PENDING
0x80000000
 GetPrinter: указывает, что система пытается завершить операцию публикации или отмены публикации, запущенную вызовом SetPrinter .
SetPrinter: это недопустимое значение.
DSPRINT_PUBLISH
0x00000001
 SetPrinter: публикует данные принтера в DS.
GetPrinter: указывает, что принтер опубликован.
DSPRINT_REPUBLISH
0x00000008
 SetPrinter. Данные DS для принтера не публикуются, а затем публикуются снова, обновляя все свойства опубликованного принтера. При повторной публикации также изменяется ИДЕНТИФИКАТОР GUID опубликованного принтера.
GetPrinter: никогда не возвращает это значение.
DSPRINT_UNPUBLISH
0x00000004
 SetPrinter: удаляет опубликованные данные принтера из DS.
GetPrinter: указывает, что принтер не опубликован.
DSPRINT_UPDATE
0x00000002
 SetPrinter: Обновления опубликованные данные принтера в DS.
GetPrinter: никогда не возвращает это значение.

Комментарии

Структура PRINTER_INFO_7 используется в вызове SetPrinter для публикации сведений о принтере в службе каталогов. Опубликованные данные содержат все значения и данные для указанного принтера, найденные в SPLDS_SPOOLER_KEY, SPLDS_DRIVER_KEY или SPLDS_USER_KEY ключах, созданных SetPrinterDataEx.

Для SetPrinterпараметру pszObjectGUID должно быть присвоено значение NULL. Для GetPrinterpszObjectGUID возвращает GUID объекта очереди печати служб каталогов, связанного с опубликованным принтером. Этот GUID можно использовать с методами ИНТЕРФЕЙСА служб Active Directory (ADSI) для получения опубликованных данных для принтера. Однако для получения опубликованных данных рекомендуется вызвать функцию GetPrinterDataEx .

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Winspool.h (включая Windows.h)
Имя в кодировке Юникод и ANSI
 _PRINTER_INFO_7W (Юникод) и _PRINTER_INFO_7A (ANSI)

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

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

Структуры API очереди печати печати