共用方式為

GetClusterNotifyV2 函式 (clusapi.h)

  • 發行項

擷取通知埠下一個通知事件的相關信息。

語法

DWORD GetClusterNotifyV2(
  [in]                HCHANGE                 hChange,
  [out]               DWORD_PTR               *lpdwNotifyKey,
  [in, out, optional] PNOTIFY_FILTER_AND_TYPE pFilterAndType,
  [in, out, optional] BYTE                    *buffer,
  [in, out, optional] LPDWORD                 lpbBufferSize,
  [in, out, optional] LPWSTR                  lpszObjectId,
  [in, out, optional] LPDWORD                 lpcchObjectId,
  [in, out, optional] LPWSTR                  lpszParentId,
  [in, out, optional] LPDWORD                 lpcchParentId,
  [in, out, optional] LPWSTR                  lpszName,
  [in, out, optional] LPDWORD                 lpcchName,
  [in, out, optional] LPWSTR                  lpszType,
  [in, out, optional] LPDWORD                 lpcchType,
  [in, optional]      DWORD                   dwMilliseconds
);

參數

[in] hChange

通知埠的句柄。 此句柄是由 CreateClusterNotifyPortV2 函式所建立。

[out] lpdwNotifyKey

通知埠之通知金鑰的指標。

[in, out, optional] pFilterAndType

描述通知埠下一個通知事件的 NOTIFY_FILTER_AND_TYPE 結構的指標。

[in, out, optional] buffer

通知事件的緩衝區指標。

[in, out, optional] lpbBufferSize

緩衝區參數大小的指標，以位元組為單位。

[in, out, optional] lpszObjectId

Unicode 字串的指標，其標識碼為觸發事件的叢集物件。 字串結尾為終止 Null 字元。

[in, out, optional] lpcchObjectId

在輸入時， DWORD 的指標，指定 lpszObjectId 參數可以保存的最大字元數，包括終止 Null 字元。 輸出時， DWORD 的指標，指定 lpszObjectId 收到的字元數，不包括終止 Null 字元。

[in, out, optional] lpszParentId

Unicode 字串的指標，其父系標識碼為觸發事件的叢集物件。 字串結尾為終止 Null 字元。

[in, out, optional] lpcchParentId

在輸入時，指定 lpszParentId 參數可以保留的最大字元數目的 DWORD 指標，包括終止的 Null 字元。 輸出時， DWORD 的指標，指定 lpszParentId 收到的字元數，不包括終止 Null 字元。

[in, out, optional] lpszName

Unicode 字串的指標，其中包含觸發事件的叢集物件名稱。 字串結尾為終止 Null 字元。

[in, out, optional] lpcchName

在輸入時， DWORD 的指標，指定 lpszName 參數可以保存的最大字元數，包括終止的 Null 字元。 輸出時， DWORD 的指標，指定 lpszName 收到的字元數，不包括終止 Null 字元。

[in, out, optional] lpszType

Unicode 字串的指標，其中包含觸發事件的叢集物件類型。 字串結尾為終止 Null 字元。

[in, out, optional] lpcchType

在輸入時，指定 lpszType 參數可以保存的最大字元數目的 DWORD 指標，包括終止的 Null 字元。 輸出時， DWORD 的指標，指定 lpszType 收到的字元數，不包括終止 Null 字元。

[in, optional] dwMilliseconds

逾時值，指定呼叫端願意等候通知的時間長度。

傳回值

如果作業成功，此函式會傳回 ERROR_SUCCESS。

如果作業失敗，此函式會傳回下列其中一個 系統錯誤碼。

傳回碼/值 Description
ERROR_INVALID_HANDLE
6
 hChange 參數中表示的句柄無效，或已由另一個線程關閉。
WAIT_TIMEOUT
258 (0x102)
成功傳回通知之前，呼叫逾時。
ERROR_MORE_DATA
234 (0xEA)
lpszName 參數所指向的緩衝區不足以保存結果。 lpcchName 參數會傳回結果中的字元數，不包括終止的 Null 字元。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2012
目標平台 Windows
標頭 clusapi.h
程式庫 ClusAPI.lib
Dll ClusAPI.dll

另請參閱

故障轉移叢集管理功能