ORCreateHive fonction)

Crée une ruche de Registre hors connexion qui contient une clé racine vide unique.

Syntaxe

DWORD ORCreateHive(
  _Out_ PORHKEY phkResult
);

Paramètres

phkResult [ à]

Pointe vers une variable pour recevoir un descripteur de la clé racine de la ruche de Registre hors connexion nouvellement créée. Si la ruche ne peut pas être créée, 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.

Si la mémoire est insuffisante pour créer la ruche du Registre, la fonction retourne une erreur de _ _ mémoire insuffisante _ .

Remarques

La fonction ORCreateHive crée une ruche de Registre hors connexion vide en mémoire. Utilisez les fonctions ORCreateKey et ORSetValue pour ajouter des clés et définir leurs valeurs.

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

ORCreateKey

OROpenHive

ORSaveHive

ORSetValue