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

Функция 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 , вызвав Release в IPrintAsyncNotifyChannel.

Сведения о том, когда следует освободить канал, см. в разделе Канал уведомлений.

Требования