Функция RouterCreatePrintAsyncNotificationChannel (prnasntp.h)

Статья
02/07/2025

Функция RouterCreatePrintAsyncNotificationChannel создает асинхронный канал уведомлений, связанный с принтером или сервером печати.

Синтаксис

HRESULT RouterCreatePrintAsyncNotificationChannel(
  [in] PCWSTR                            pName,
  [in] PrintAsyncNotificationType        *pNotificationType,
       PrintAsyncNotifyUserFilter        eNotifyFilter,
  [in] PrintAsyncNotifyConversationStyle eConversationStyle,
  [in] IPrintAsyncNotifyCallback         *pCallback,
       IPrintAsyncNotifyChannel          **ppIAsynchNotification
);

Параметры

[in] pName

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

[in] pNotificationType

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

eNotifyFilter

Фильтр сеанса или пользователя, получающего уведомления.

[in] eConversationStyle

Тип связи: однонаправленный или двунаправленный.

[in] pCallback

Указатель на функцию обратного вызова, которая вызывается для доставки уведомлений о ответе, когда двунаправленная связь действует. Этот параметр игнорируется при действии однонаправленного взаимодействия.

ppIAsynchNotification

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

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

RouterCreatePrintAsyncNotificationChannel возвращает S_OK при успешном выполнении и возвращает стандартный код ошибки COM в противном случае.

Замечания

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

Сведения о выпуске канала см. в канале уведомлений.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prnasntp.h (include Prnasntp.h)
библиотеки	Spoolss.lib
DLL	Spoolss.dll

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