FONCTION ORSaveHive

Écrit la ruche de Registre hors connexion spécifiée dans un fichier.

Syntaxe

DWORD ORSaveHive(
  _In_ ORHKEY Handle,
  _In_ PCWSTR lpHivePath,
  _In_ DWORD  dwOsMajorVersion,
  _In_ DWORD  dwOsMinorVersion
);

Paramètres

Handle [in]

Handle dans la ruche du Registre hors connexion à enregistrer.

lpHivePath [in]

Pointeur vers une chaîne Unicode qui spécifie le nom du fichier hive du Registre. Il ne peut pas s’agir du nom d’un fichier existant.

dwOsMajorVersion [in]

Numéro de version principale du système d’exploitation. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
5	Si dwOsMinorVersion a la valeur 1, le système d’exploitation est Windows XP. Si dwOsMinorVersion a la valeur 2, le système d’exploitation est Windows Server 2003 R2, Windows Server 2003 ou Windows XP Professionnel Édition x64.
6	Si dwOsMinorVersion a la valeur 0, le système d’exploitation est Windows Server 2008 ou Windows Vista. Si dwOsMinorVersion a la valeur 1, le système d’exploitation est Windows Server 2008 R2 ou Windows 7.

 

dwOsMinorVersion [in]

Numéro de version secondaire du système d’exploitation. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
0	Si dwOsMajorVersion a la valeur 6, le système d’exploitation est Windows Server 2008 ou Windows Vista.
1	Si dwOsMajorVersion a la valeur 5, le système d’exploitation est Windows XP. Si dwOsMajorVersion a la valeur 6, le système d’exploitation est Windows Server 2008 R2 ou Windows 7.
2	Si dwOsMajorVersion a la valeur 5, le système d’exploitation est Windows Server 2003 R2, Windows Server 2003 ou Windows XP Professionnel Édition x64. Si dwOsMajorVersion a la valeur 6, le paramètre dwOsMinorVersion doit être 0 ou 1.

 

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 l’appelant ne dispose pas des droits d’accès nécessaires pour écrire le fichier, la fonction retourne ERROR_ACCESS_DENIED.
• Si le fichier spécifié existe déjà, la fonction retourne ERROR_ALREADY_EXISTS.

Notes

La fonction ORSaveHive doit être utilisée pour enregistrer les modifications apportées à une ruche de Registre hors connexion. Les modifications ne sont pas conservées tant que ORSaveHive n’est pas appelé pour enregistrer la ruche dans un fichier.

Les paramètres dwOsMajorVersion et dwOsMinorVersion spécifient ensemble le format cible du fichier hive du Registre. Le tableau suivant récapitule les numéros de version de système d’exploitation les plus récents.

Système d’exploitation	Numéro de version
Windows Server 2008 R2	6.1
Windows 7	6.1
Windows Server 2008	6.0
Windows Vista	6.0
Windows Server 2003 R2	5.2
Windows Server 2003	5.2
Windows XP Professionnel Édition x64	5.2
Windows XP	5,1

 

Utilisez la fonction GetVersionEx pour récupérer des informations sur le système d’exploitation actuel.

La fonction ORSaveHive verrouille la ruche du Registre pendant qu’elle écrit la ruche dans le fichier, puis ferme le fichier et libère le verrou. La ruche du Registre reste en mémoire jusqu’à ce qu’elle soit fermée en appelant la fonction ORCloseHive . Il est possible d’apporter d’autres modifications à la ruche du Registre pendant qu’elle est ouverte ; Toutefois, pour conserver ces modifications, la ruche doit être enregistrée dans un nouveau fichier, car la fonction ORSaveHive ne remplacera pas un fichier existant.

La fonction ORSaveHive peut être utilisée pour enregistrer une partie de la ruche du Registre hors connexion. La clé spécifiée dans le paramètre Handle devient la clé racine d’une ruche qui se compose de la clé spécifiée et de toutes ses sous-clés.

Spécifications

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

Voir aussi

GetVersionEx

ORCloseHive

OROpenHive