FONCTION OROpenKey
Ouvre la clé de Registre spécifiée dans une ruche de Registre hors connexion.
Syntaxe
DWORD OROpenKey(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKeyName,
_Out_ PORHKEY phkResult
);
Paramètres
-
Gérer [in]
-
Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.
-
lpSubKeyName [in, facultatif]
-
Pointeur vers une chaîne UNICODE qui contient le nom de la clé de Registre à ouvrir. Cette clé doit être une sous-clé de la clé identifiée par le paramètre Handle .
Les noms de clés ne respectent pas la casse.
Si ce paramètre a la valeur NULL ou un pointeur vers une chaîne vide, la fonction retourne le même handle qui a été transmis. Si la clé spécifiée par le paramètre Handle est la clé racine de la ruche, la fonction retourne ERROR_INVALID_PARAMETER.
Pour plus d’informations, consultez Limites de taille des éléments du Registre.
-
phkResult [out]
-
Pointeur vers une variable qui reçoit un handle vers la clé ouverte. Utilisez la fonction ORCloseKey pour fermer la clé une fois que vous avez terminé d’utiliser le handle.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
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 l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.
Si le handle à retourner est un handle à la clé racine de la ruche, la fonction retourne ERROR_INVALID_PARAMETER.
Si la clé spécifiée a été marquée comme supprimée, cette fonction retourne ERROR_KEY_DELETED.
Notes
La fonction OROpenKey ne peut pas être utilisée pour ouvrir la clé racine dans une ruche de Registre hors connexion. Pour obtenir un handle sur la clé racine d’une ruche, utilisez la fonction OROpenHive pour charger la ruche en mémoire.
Spécifications
| Condition requise | Valeur |
|---|---|
| Composant redistribuable |
Bibliothèque du Registre hors connexion Windows version 1.0 ou ultérieure |
| En-tête |
|
| DLL |
|
Voir aussi