共用方式為

GetClusterInformation 函式 (clusapi.h)

  • 發行項

擷取 叢集 的名稱和版本。 PCLUSAPI_GET_CLUSTER_INFORMATION類型會定義此函式的指標。

語法

DWORD GetClusterInformation(
  [in]            HCLUSTER             hCluster,
  [out]           LPWSTR               lpszClusterName,
  [in, out]       LPDWORD              lpcchClusterName,
  [out, optional] LPCLUSTERVERSIONINFO lpClusterInfo
);

參數

[in] hCluster

叢集的句柄。

[out] lpszClusterName

以 Null 結尾的 Unicode 字串指標，其中包含 hCluster 所識別的叢集名稱。

[in, out] lpcchClusterName

lpszClusterName 緩衝區大小做為字元計數的指標。 在輸入上，指定緩衝區可以保留的最大字元數，包括終止 的NULL。 在輸出上，指定結果名稱中的字元數，不包括終止 的NULL。

[out, optional] lpClusterInfo

NULL 或描述叢集服務版本的 CLUSTERVERSIONINFO 結構的指標。 當 lpClusterInfo 不是 NULL 時，應該設定此結構的 dwVersionInfoSize 成員，如下所示： lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

傳回值

如果作業成功，函式會傳回 ERROR_SUCCESS ( 0) 。

如果作業失敗，函式會傳回 系統錯誤碼。 以下是其中一個可能的值。

傳回碼 Description
ERROR_MORE_DATA
 lpszClusterName 所指向的緩衝區不夠大，無法保存結果。 lpcchClusterName 參數會傳回結果中的字元數，不包括終止 NULL。

備註

請注意， lpcchClusterName 是指字元計數，而不是位元組計數，而且傳回的大小不包含計數中的終止 NULL 。 如需調整緩衝區大小的詳細資訊，請參閱 數據大小慣例。

規格需求

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

另請參閱

CLUSTERVERSIONINFO