GetClusterQuorumResource 函式 (clusapi.h)
傳回叢集仲裁 資源的名稱。 PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE類型會定義此函式的指標。
語法
DWORD GetClusterQuorumResource(
[in] HCLUSTER hCluster,
[out] LPWSTR lpszResourceName,
[in, out] LPDWORD lpcchResourceName,
[out] LPWSTR lpszDeviceName,
[in, out] LPDWORD lpcchDeviceName,
[out] LPDWORD lpdwMaxQuorumLogSize
);
參數
[in] hCluster
處理現有的 叢集。
[out] lpszResourceName
Null 終止的 Unicode 字串指標,其中包含叢集仲裁資源的名稱。 此名稱是從仲裁資源的 Name 通用屬性讀取。 請勿傳遞此參數的 NULL 。
[in, out] lpcchResourceName
lpszResourceName 緩衝區大小做為字元計數的指標。 在輸入上,指定緩衝區可以保留的最大字元數,包括終止 的NULL。 在輸出上,指定結果名稱中的字元數,不包括終止 的NULL。
[out] lpszDeviceName
Null 終止的 Unicode 字串指標,其中包含 叢集服務所維護仲裁記錄檔位置的路徑。 請勿傳遞此參數的 NULL 。
[in, out] lpcchDeviceName
lpszDeviceName 緩衝區大小做為字元計數的指標。 在輸入上,指定緩衝區可以保留的最大字元數,包括終止 的NULL。 在輸出上,指定結果名稱中的字元數,不包括終止 的NULL。
[out] lpdwMaxQuorumLogSize
仲裁資源所維護之記錄檔) 位元組大小上限 (指標。 請勿傳遞此參數的 NULL 。
傳回值
如果作業成功,函式會傳回 ERROR_SUCCESS。
如果作業失敗,函式會傳回 系統錯誤碼。 以下是其中一個可能的值。
傳回碼 | Description |
---|---|
|
lpszResourceName 或 lpszDeviceName 緩衝區不夠大,無法保存結果。 lpcchResourceName 和 lpcchDeviceName 參數會傳回結果中的字元數,不包括終止 NULL。 |
備註
請注意, lpcchName 是指字元計數,而不是位元組計數,而且傳回的大小不包含計數中的終止 NULL 。 如需調整緩衝區大小的詳細資訊,請參閱 數據大小慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
目標平台 | Windows |
標頭 | clusapi.h |
程式庫 | ClusAPI.lib |
Dll | ClusAPI.dll |