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 中指定的其中一種類型事件時,dwNotifyKey 參數會從 GetClusterNotifyV2 傳回。
傳回值
如果作業成功,函式會傳回通知埠句柄。
如果作業失敗,函式會傳回 NULL。 如需錯誤的詳細資訊,請呼叫 GetLastError。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2012 |
目標平台 | Windows |
標頭 | clusapi.h |
程式庫 | ClusAPI.lib |
Dll | ClusAPI.dll |