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 的指针，该 GUID 表示通过此通道发送的通知的类型。

eNotifyFilter

接收通知的会话或用户的筛选器。

[in] eConversationStyle

通信类型：单向或双向。

[in] pCallback

指向回调函数的指针，该回调函数在双向通信生效时传递响应通知。 当单向通信生效时，将忽略此参数。

ppIAsynchNotification

指向变量的指针，该变量接收表示通知通道的接口对象的地址。

返回值

RouterCreatePrintAsyncNotificationChannel 在成功时返回 S_OK ，否则返回标准 COM 错误代码。

注解

在某些情况下，必须通过调用 IPrintAsyncNotifyChannel 上的 Release 来释放使用 RouterCreatePrintAsyncNotificationChannel 函数创建的通道。

有关何时发布频道的信息，请参阅 通知通道。

要求