OROpenHive, fonction
Charge le fichier hive de Registre spécifié en mémoire et valide la ruche.
Syntaxe
DWORD OROpenHive(
_In_ PCWSTR lpHivePath,
_Out_ PORHKEY phkResult
);
Paramètres
-
lpHivePath [in]
-
Pointeur vers une chaîne Unicode qui spécifie le nom du fichier hive du Registre à charger en mémoire. Il peut s’agir d’un fichier hive qui a été enregistré avec la fonction ORSaveHive ou créé avec la fonction RegSaveKey ou RegSaveKeyEx . La taille du fichier doit être inférieure à 4 Go et l’appelant doit avoir FILE_READ_DATA accès au fichier. Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.
-
phkResult [out]
-
Pointeur vers une variable qui reçoit un handle vers la clé racine de la ruche de Registre hors connexion chargée. Si le fichier hive du Registre ne peut pas être ouvert ou si la validation échoue, la fonction définit ce paramètre sur NULL.
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. Les codes d’erreur possibles sont les suivants :
- Si le fichier est vide ou supérieur à 4 Go, la fonction retourne ERROR_BADDB.
- Si l’appelant ne dispose pas des droits d’accès nécessaires pour ouvrir le fichier, la fonction retourne ERROR_ACCESS_DENIED.
- Si la ruche du Registre échoue à la validation, la fonction retourne ERROR_NOT_REGISTRY_FILE.
Notes
La fonction OROpenHive est la seule fonction de Registre hors connexion qui valide une ruche de Registre. Si la validation échoue, aucune tentative de réparation de la ruche n’est effectuée.
Spécifications
| Condition requise | Valeur |
|---|---|
| Composant redistribuable |
Bibliothèque du Registre windows hors connexion version 1.0 ou ultérieure |
| En-tête |
|
| DLL |
|
Voir aussi