OROpenHive fonction)

Charge le fichier ruche de Registre spécifié en mémoire et valide la ruche.

Syntaxe

DWORD OROpenHive(
  _In_  PCWSTR  lpHivePath,
  _Out_ PORHKEY phkResult
);

Paramètres

lpHivePath [ dans]

Pointeur vers une chaîne Unicode qui spécifie le nom du fichier ruche 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 disposer _ d’un _ accès aux données en lecture du fichier. Pour plus d’informations, consultez sécurité des fichiers et droits d’accès.

phkResult [ à]

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 ruche du registre ne peut pas être ouvert ou si la validation échoue, la fonction affecte la valeur null à ce paramètre.

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. Les codes d’erreur possibles sont les suivants :

  • Si la taille du fichier est vide ou supérieure à 4 Go, la fonction retourne l’erreur _ BADDB.
  • Si l’appelant ne dispose pas des droits d’accès nécessaires pour ouvrir le fichier, la fonction retourne l’erreur _ accès _ refusé.
  • Si la ruche du Registre échoue à la validation, la fonction retourne l’erreur _ non _ fichier du Registre _ .

Remarques

La fonction OROpenHive est la seule fonction de Registre hors connexion qui valide une ruche de registre. Si la validation échoue, aucune tentative n’est faite pour réparer la 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

ORCloseHive

ORCreateHive

ORSaveHive

RegSaveKey

RegSaveKeyEx