Partager via


Fonction ClusterRegOpenKey (clusapi.h)

Ouvre une clé de base de données de cluster existante.

Syntaxe

LONG ClusterRegOpenKey(
  [in]  HKEY    hKey,
  [in]  LPCWSTR lpszSubKey,
  [in]  REGSAM  samDesired,
  [out] PHKEY   phkResult
);

Paramètres

[in] hKey

Gérez vers une clé actuellement ouverte. Ce paramètre ne peut pas être NULL.

[in] lpszSubKey

Pointeur vers une chaîne Unicode terminée par un caractère Null spécifiant le nom de la sous-clé à créer ou à ouvrir. Le paramètre lpszSubKey doit pointer vers une sous-clé qui :

  • Clé enfant de la clé identifiée par hKey.
  • Ne doit pas commencer par la barre oblique inverse ( \ ).
  • Ne doit pas être NULL.
Le paramètre lpszSubKey peut pointer vers une chaîne vide, ce qui amène ClusterRegCreateKey à retourner un handle à la clé de base de données représentée par hKey.

[in] samDesired

Masque d’accès qui spécifie l’accès de sécurité nécessaire pour la nouvelle clé.

[out] phkResult

Pointeur vers un handle vers la clé ouverte ou créée.

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS.

Si l’opération échoue, la fonction retourne un code d’erreur système.

Remarques

Les appelants doivent appeler ClusterRegCloseKey pour fermer le handle de clé ouvert par ClusterRegOpenKey lorsqu’ils en ont terminé.

Configuration requise

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

Voir aussi

ClusterRegCloseKey

ClusterRegCreateKey