Fonction OpenClusterResourceEx (clusapi.h)

Article
08/22/2023

Ouvre une ressource et lui retourne un handle.

Syntaxe

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

Paramètres

[in] hCluster

Gérer vers un cluster.

[in, optional] lpszResourceName

Pointeur vers une chaîne Unicode terminée par null contenant le nom de la ressource à ouvrir.

Les noms de ressources ne respectent pas la casse. Un nom de ressource doit être unique au sein du cluster. Le nom est défini lors de la création de la ressource et peut être modifié à l’aide de la fonction SetClusterResourceName .

[in] dwDesiredAccess

Privilèges d’accès demandés. Il peut s’agir d’une combinaison de GENERIC_READ (0x80000000), de GENERIC_ALL (0x10000000) ou de MAXIMUM_ALLOWED (0x02000000). Si cette valeur est égale à zéro (0) et qu’une erreur non définie peut être retournée. Utiliser GENERIC_ALL revient à appeler OpenClusterResource.

[out, optional] lpdwGrantedAccess

Paramètre facultatif qui contient l’adresse d’un DWORD qui recevra les droits d’accès accordés. Si le paramètre DesiredAccess est MAXIMUM_ALLOWED (0x02000000), le DWORD pointé par ce paramètre contiendra le nombre maximal de privilèges accordés à cet utilisateur.

Valeur retournée

Si l’opération a réussi, OpenClusterResourceEx retourne un handle à la ressource ouverte.

Code de retour	Description
NULL	L’opération n’a pas réussi. Pour plus d’informations sur l’erreur, appelez la fonction GetLastError . Si le serveur cible ne prend pas en charge la fonction OpenClusterResourceEx (par exemple, si le serveur cible exécute Windows Server 2008 ou une version antérieure), la fonction GetLastError retourne RPC_S_PROCNUM_OUT_OF_RANGE (1745).

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Entreprise
Plateforme cible	Windows
En-tête	clusapi.h
Bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Voir aussi

CloseClusterResource

Fonctions de gestion des ressources du cluster de basculement

OpenClusterResource

Partager via