Fonction ClusterRegCreateKey (clusapi.h)
Crée une clé de base de données de cluster spécifiée. Si la clé existe déjà dans la base de données, ClusterRegCreateKey l’ouvre sans apporter de modifications.
Syntaxe
LONG ClusterRegCreateKey(
[in] HKEY hKey,
[in] LPCWSTR lpszSubKey,
[in] DWORD dwOptions,
[in] REGSAM samDesired,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
[out] PHKEY phkResult,
[out, optional] LPDWORD lpdwDisposition
);
Paramètres
[in] hKey
Gérez une clé de base de données de cluster 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.
[in] dwOptions
Spécifie des options spéciales pour cette clé. Actuellement, dwOptions peut être défini sur la valeur suivante.
REG_OPTION_NON_VOLATILE (0x00000000)
La clé ouverte ou créée n’est pas volatile ; les informations sont conservées lors du redémarrage du système.
[in] samDesired
Masque d’accès qui spécifie l’accès de sécurité nécessaire pour la nouvelle clé. Les valeurs suivantes sont valides.
Pour plus d’informations, consultez Sécurité de la clé de Registre et droits d’accès.
ACCESS_SYSTEM_SECURITY (0x01000000)
Autorisation d’accéder à la sécurité du système. Il est utilisé pour indiquer l’accès à une liste de contrôle d’accès système (SACL). Ce type d’accès nécessite que le processus appelant dispose du privilège SE_SECURITY_NAME (Gérer l’audit et le journal de sécurité).
DELETE (0x00010000)
Autorisation de suppression.
KEY_ALL_ACCESS (0x000F003F)
Combinaison d’accès KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, KEY_NOTIFY, KEY_CREATE_SUB_KEY, KEY_CREATE_LINK et KEY_SET_VALUE .
KEY_CREATE_LINK (0x00000020)
Autorisation de créer un lien symbolique.
KEY_ENUMERATE_SUB_KEYS (0x00000008)
Autorisation d’énumérer les sous-clés.
KEY_EXECUTE (0x00020019)
Autorisation pour l’accès en lecture.
KEY_NOTIFY (0x00000010)
Autorisation pour la notification de modification.
KEY_QUERY_VALUE (0x00000001)
Autorisation d’interroger les données de sous-clé.
KEY_READ (0x00020019)
Combinaison d’accès KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS et KEY_NOTIFY .
KEY_SET_VALUE (0x00000002)
Autorisation de modifier les données de sous-clé.
KEY_WRITE (0x00020006)
Combinaison d’accès KEY_SET_VALUE et KEY_CREATE_SUB_KEY .
READ_CONTROL (0x00020000)
Autorisation de lire le propriétaire, le groupe et la liste de contrôle d’accès discrétionnaire (DACL) du descripteur de sécurité.
WRITE_DAC (0x00040000)
Autorisation d’écrire dans la liste DACL.
WRITE_OWNER (0x00080000)
Autorisation de modifier le propriétaire.
[in, optional] lpSecurityAttributes
Ce paramètre est ignoré. Pour définir les attributs de sécurité sur une nouvelle clé de Registre, appelez la fonction ClusterRegSetKeySecurity après que ClusterRegCreateKey a été retourné avec succès.
[out] phkResult
Pointeur vers le handle de la clé ouverte ou créée.
[out, optional] lpdwDisposition
Pointeur vers une valeur qui indique si la clé pointée par lpszSubKey a été ouverte ou créée. Les valeurs suivantes sont valides.
REG_CREATED_NEW_KEY (0x00000001)
La clé n’existait pas et a été créée.
REG_OPENED_EXISTING_KEY (0x00000002)
La clé existait et a été ouverte.
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é créé par la fonction ClusterRegCreateKey lorsqu’ils en ont terminé.
N’appelez pas ClusterRegCreateKey à partir des fonctions de point d’entrée dll de ressource suivantes :
ClusterRegCreateKey peut être appelé en toute sécurité à partir de toute autre fonction de point d’entrée DLL de ressource ou à partir d’un thread de travail. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.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 |