Partager via


FONCTION ORCreateHive

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

Syntaxe

DWORD ORCreateHive(
  _Out_ PORHKEY phkResult
);

Paramètres

phkResult [out]

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

Si la mémoire est insuffisante pour créer la ruche du Registre, la fonction retourne ERROR_NOT_ENOUGH_MEMORY.

Notes

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.

Spécifications

Condition requise Valeur
Composant redistribuable
Bibliothèque du Registre hors connexion Windows version 1.0 ou ultérieure
En-tête
Offreg.h
DLL
Offreg.dll

Voir aussi

ORCreateKey

OROpenHive

ORSaveHive

ORSetValue