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 |
|
| DLL |
|