共用方式為

openClusterGroupEx 函式 (clusapi.h)

  • 發行項

開啟故障轉移叢集 群組 ，並傳回它的句柄。

語法

HGROUP OpenClusterGroupEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszGroupName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

參數

[in] hCluster

包含要開啟之群組的叢集句柄。

[in, optional] lpszGroupName

要開啟的組名。

[in] dwDesiredAccess

要求的存取許可權。 這可能是 GENERIC_READ (0x80000000) 、 GENERIC_ALL (0x10000000) 或 MAXIMUM_ALLOWED (0x02000000) 的任何組合。 如果此值為零 (0) ，則可能會傳回未定義的錯誤。 使用 GENERIC_ALL 與呼叫 OpenClusterGroup 相同。

[out, optional] lpdwGrantedAccess

選擇性參數，其中包含將接收授與訪問許可權的 DWORD 位址。 如果 DesiredAccess 參數 MAXIMUM_ALLOWED (0x02000000) 則此參數所指向的 DWORD 將會包含授與此使用者的最大許可權。

傳回值

如果作業成功， OpenClusterGroupEx 會 傳回群組句柄。

傳回碼 Description
NULL
 作業未成功。 如需錯誤的詳細資訊，請呼叫 GetLastError 函 式。 如果目標伺服器不支援 OpenClusterGroupEx 函式 (例如，如果目標伺服器執行 Windows Server 2008 或更早版本 ) ，GetLastError 函式會傳回 RPC_S_PROCNUM_OUT_OF_RANGE (1745) 。

規格需求

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

另請參閱

CloseClusterGroup

群組管理功能

OpenClusterGroup