createClusterNotifyPortV2 函数 (clusapi.h)
创建或修改通知端口。 有关通知端口的信息,请参阅 接收群集事件。
语法
HCHANGE CreateClusterNotifyPortV2(
[in] HCHANGE hChange,
[in] HCLUSTER hCluster,
[in] NOTIFY_FILTER_AND_TYPE *Filters,
[in] DWORD dwFilterCount,
[in] DWORD_PTR dwNotifyKey
);
参数
[in] hChange
通知端口或 INVALID_HANDLE_VALUE的句柄,指示应创建新的句柄。 如果 hChange 参数是现有句柄,则 dwFilter 参数中指定的事件将添加到通知端口。
[in] hCluster
要与 hChange 参数或INVALID_HANDLE_VALUE标识的通知端口关联的群集句柄,指示通知端口不应与群集相关联。 如果 hChange 参数未设置为 INVALID_HANDLE_VALUE,则 hCluster 参数不能设置为 INVALID_HANDLE_VALUE。
[in] Filters
指向 NOTIFY_FILTER_AND_TYPE 结构的指针,该结构指定端口可以接受的通知类型。
[in] dwFilterCount
由 Filters 参数指定的 筛选器 数。
[in] dwNotifyKey
一个用户指定的值,该值与从通知端口检索通知相关联。 当发生 Filters 中指定的类型之一的事件时,将从 GetClusterNotifyV2 返回 dwNotifyKey 参数。
返回值
如果操作成功,该函数将返回通知端口句柄。
如果操作失败,该函数将返回 NULL。 有关错误的详细信息,请调用 GetLastError。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2012 |
目标平台 | Windows |
标头 | clusapi.h |
Library | ClusAPI.lib |
DLL | ClusAPI.dll |