IPrintAsyncNotifyCallback::OnEventNotify 方法 (prnasnot.h)

向侦听器发出警报,指出通知在指定通道上可用。 打印系统调用此方法。

语法

HRESULT OnEventNotify(
  [in] IPrintAsyncNotifyChannel    *pChannel,
  [in] IPrintAsyncNotifyDataObject *pData
);

参数

[in] pChannel

指向发送方和侦听器使用的通道的指针。

[in] pData

指向包含通知数据及其大小和类型的 对象的指针。

返回值

HRESULT 严重性 含义
S_OK 成功 函数已成功完成。
INTERNAL_NOTIFICATION_QUEUE_IS_FULL ERROR 打印后台处理程序不能再保留任何排队通知。 默认情况下,队列的最大大小为 10 个通知。 返回此错误时,侦听应用程序处理通知的速度不如发送通知快。 应重新发送或放弃此通知。
 

返回值为 COM 错误代码。 由于此函数可能成功完成操作,但返回除S_OK以外的 HRESULT,因此应使用 SUCCEEDED 或 FAILED 宏来确定调用是否成功。 若要获取函数返回的特定 HRESULT,请使用 HRESULT_CODE 宏。

有关其他可能的返回值,请参阅 PrintAsyncNotifyError

有关 COM 错误代码的详细信息,请参阅错误处理

下面的代码示例演示如何使用这些宏来计算返回值。

if (SUCCEEDED(hr)){
  // Call was successful 
}

if (FAILED(hr)) {
  // Call failed 
}

if (FAILED(hr)) {
  // Call failed, check HRESULT value returned
  switch (HRESULT_CODE(hr)){
    case INTERNAL_NOTIFICATION_QUEUE_IS_FULL:
      // Some action 
      break;
    default:
      // Default action 
      break;
  }
} else {
  // Call succeeded 
}

注解

为了传递通知,打印后台处理程序将在注册通知时调用侦听应用程序提供的 IPrintAsyncNotifyCallback 对象的 OnEventNotify 方法。 对于单向通知, pChannelNULL。 对于双向通道, pChannel 指向侦听应用程序用来发送响应通知的 IPrintAsyncNotifyChannel 。 侦听器将通过调用 IPrintAsyncNotifyChannelSendNotification 方法执行此操作。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 prnasnot.h
DLL Prnasnot.dll

另请参阅

异步打印通知接口

错误处理

IPrintAsyncNotifyCallback

打印