ClusterRegGetBatchNotification 函数 (clusapi.h)

提取批通知。 获取批通知后,将通过 ClusterRegBatchReadCommand 函数对其进行解释。 处理批处理通知后,需要通过 ClusterRegBatchCloseNotification 函数将其关闭。

语法

LONG ClusterRegGetBatchNotification(
  [in]  HREGBATCHPORT         hBatchNotify,
  [out] HREGBATCHNOTIFICATION *phBatchNotification
);

参数

[in] hBatchNotify

前面通过 ClusterRegCreateBatchNotifyPort 函数打开的批处理通知端口的句柄。

[out] phBatchNotification

批处理通知的句柄,表示自上次调用 ClusterRegGetBatchNotification 或打开批通知端口后,在相关群集注册表项处或下方发生的所有更改。

返回值

函数返回以下 系统错误代码之一。

返回代码/值 说明
ERROR_SUCCESS
0
操作成功。
ERROR_INVALID_DATA
13 (0xD)
数据无效。
ERROR_OUTOFMEMORY
14 (0xE)
没有足够的存储空间来完成此操作。
ERROR_GEN_FAILURE
31 (0x1F)
附加到系统的设备无法正常工作。

注解

PCLUSTER_REG_GET_BATCH_NOTIFICATION类型定义指向此函数的指针。

只有批处理函数组中的函数(如 ClusterRegBatchAddCommand)才会生成注册表更改通知。 不使用批处理函数命令之一的注册表更改不会生成批处理通知。

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 Datacenter、Windows Server 2008 Enterprise
目标平台 Windows
标头 clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

另请参阅

群集注册表访问函数

ClusterRegBatchCloseNotification

ClusterRegBatchReadCommand

ClusterRegCreateBatchNotifyPort