ORCreateKey fonction)

Crée la clé de Registre spécifiée dans une ruche de Registre hors connexion. Si la clé existe déjà, la fonction l’ouvre.

Syntaxe

DWORD ORCreateKey(
  _In_      ORHKEY               Handle,
  _In_      PCWSTR               lpSubKey,
  _In_opt_  PWSTR                lpClass,
  _In_opt_  DWORD                dwOptions,
  _In_opt_  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  _Out_     PORHKEY              phkResult,
  _Out_opt_ PDWORD               pdwDisposition
);

Paramètres

Gérer [ dans]

Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.

lpSubKey [ dans]

Pointeur vers une chaîne Unicode qui contient le nom d’une sous-clé que cette fonction ouvre ou crée. Le paramètre lpSubKey doit spécifier une sous-clé de la clé identifiée par le paramètre handle ; Il peut atteindre jusqu’à 32 niveaux de profondeur dans l’arborescence du Registre. Pour plus d’informations sur les noms de clé, consultez structure du Registre.

Ce paramètre ne peut pas être null.

Les noms de clés ne respectent pas la casse.

lpClass [ dans, facultatif]

Classe (type d’objet) de cette clé. Ce paramètre peut être ignoré. Ce paramètre peut être NULL.

dwOptions [ dans, facultatif]

Ce paramètre peut avoir la valeur 0 ou l’une des valeurs suivantes.

Valeur Signification
Reg _ OPTION de _ création de _ lien
0x00000002L
La clé est un lien symbolique. Le chemin d’accès cible est assigné à la valeur de L' « SymbolicLinkValue » de la clé. Le chemin d’accès cible doit être un chemin d’accès absolu au registre. Si cette option est définie, l' _ option reg _ non _ volatile doit également être définie.
Si le paramètre lpSubKey spécifie une clé existante, il doit avoir été créé avec l' _ option reg _ Create _ Link.
Les liens symboliques du Registre doivent être utilisés uniquement lorsque cela est absolument nécessaire pour la compatibilité des applications.
Reg _ OPTION _ non _ volatile
0x00000000L
La clé n’est pas volatile. Il s’agit de la valeur par défaut. Les informations sont stockées dans un fichier et sont conservées lorsque le système est redémarré. La fonction ORSaveHive enregistre les clés qui ne sont pas volatiles.

pSecurityDescriptor [ dans, facultatif]

Pointeur vers une structure de _ descripteur de sécurité qui contient un descripteur de sécurité pour la nouvelle clé. Si pSecurityDescriptor a la valeur null, la clé obtient un descripteur de sécurité par défaut. Les listes de contrôle d’accès dans un descripteur de sécurité par défaut pour une clé sont héritées de sa clé parente directe.

phkResult [ à]

Pointeur vers une variable qui reçoit un handle vers la clé ouverte ou créée. Utilisez la fonction ORCloseKey pour fermer la clé une fois que vous avez fini d’utiliser le handle.

pdwDisposition [ out, facultatif]

Pointeur vers une variable qui reçoit l’une des valeurs de disposition suivantes.

Valeur Signification
Reg _ _Nouvelle _ clé
0x00000001L
créée
La clé n’existait pas et a été créée.
Reg _ 0x00000002L _ _ clé existante ouverte
La clé existait et a simplement été ouverte sans être modifiée.

Si pdwDisposition a la valeur null, aucune information de disposition n’est retournée.

Valeur retournée

Si la fonction réussit, la valeur de retour est une erreur de _ réussite.

Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro défini dans Winerror. h. Vous pouvez utiliser la fonction FormatMessage avec le format _ message _ de l' _ indicateur système pour obtenir une description générique de l’erreur.

Si le paramètre dwOptions est défini avec l' _ option reg _ Create _ Link mais que l' _ option reg _ non _ volatile est désactivée, ou si le handle à retourner est un descripteur de la clé racine de Hive, la fonction retourne un paramètre d’erreur _ non valide _ .

Remarques

La clé créée par la fonction ORCreateKey n’a pas de valeur. Une application peut utiliser la fonction ORSetValue pour définir des valeurs de clés.

La fonction ORCreateKey ne peut pas être utilisée pour créer la clé racine dans une ruche de Registre hors connexion. Utilisez la fonction ORCreateHive pour créer la clé racine et obtenir un descripteur de la clé.

Le registre hors connexion ne prend pas en charge l’enregistrement de clés individuelles. Utilisez la fonction ORSaveHive pour enregistrer une clé et ses sous-clés dans une ruche.

Configuration requise

Condition requise Valeur
Composant redistribuable
Windows Bibliothèque de Registre hors connexion version 1,0 ou ultérieure
En-tête
Offreg. h
DLL
Offreg.dll

Voir aussi

ORCloseKey

ORCreateHive

ORDeleteKey

ORSaveHive

descripteur de sécurité _