Funzione OpenClusterGroupEx (clusapi.h)

Articolo
02/24/2024

Apre un gruppo di cluster di failover e restituisce un handle.

Sintassi

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

Parametri

[in] hCluster

Gestire in un cluster che include il gruppo da aprire.

[in, optional] lpszGroupName

Nome del gruppo da aprire.

[in] dwDesiredAccess

Privilegi di accesso richiesti. Può trattarsi di qualsiasi combinazione di GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) o MAXIMUM_ALLOWED (0x02000000). Se questo valore è zero (0) e potrebbe essere restituito un errore non definito. L'uso di GENERIC_ALL equivale a chiamare OpenClusterGroup.

[out, optional] lpdwGrantedAccess

Parametro facoltativo che contiene l'indirizzo di un DWORD che riceverà i diritti di accesso concessi. Se il parametro DesiredAccess è MAXIMUM_ALLOWED (0x02000000), il DWORD a cui punta questo parametro conterrà i privilegi massimi concessi all'utente.

Valore restituito

Se l'operazione ha avuto esito positivo, OpenClusterGroupEx restituisce un handle di gruppo.

Codice restituito	Descrizione
NULL	L'operazione non è riuscita. Per altre informazioni sull'errore, chiamare la funzione GetLastError . Se il server di destinazione non supporta la funzione OpenClusterGroupEx ,ad esempio se il server di destinazione esegue Windows Server 2008 o versioni precedenti, la funzione GetLastError restituirà RPC_S_PROCNUM_OUT_OF_RANGE (1745).

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll

Vedi anche

CloseClusterGroup

Funzioni di gestione dei gruppi

OpenClusterGroup

Condividi tramite