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

另请参阅

故障转移群集管理功能