Funzione OpenClusterResourceEx (clusapi.h)

Articolo
08/22/2023

Apre una risorsa e restituisce un handle.

Sintassi

HRESOURCE OpenClusterResourceEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszResourceName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parametri

[in] hCluster

Gestire in un cluster.

[in, optional] lpszResourceName

Puntatore a una stringa Unicode con terminazione null contenente il nome della risorsa da aprire.

I nomi delle risorse non sono distinzione tra maiuscole e minuscole. Un nome di risorsa deve essere univoco all'interno del cluster. Il nome viene impostato quando la risorsa viene creata e può essere modificata usando la funzione SetClusterResourceName .

[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 un errore non definito può essere restituito. L'uso di GENERIC_ALL equivale alla chiamata di OpenClusterResource.

[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 esito positivo, OpenClusterResourceEx restituisce un handle alla risorsa aperta.

Codice restituito	Descrizione
NULL	L'operazione non ha avuto esito positivo. Per altre informazioni sull'errore, chiamare la funzione GetLastError . Se il server di destinazione non supporta la funzione OpenClusterResourceEx , 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


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

CloseClusterResource

Funzioni di gestione delle risorse del cluster di failover

OpenClusterResource

Condividi tramite