RegLoadKeyA, fonction (winreg.h)

Article
08/27/2023

Crée une sous-clé sous HKEY_USERS ou HKEY_LOCAL_MACHINE et charge les données de la ruche de Registre spécifiée dans cette sous-clé.

Les applications qui sauvegardent ou restaurent l’état du système, y compris les fichiers système et les ruches du Registre, doivent utiliser le service de cliché instantané de volume au lieu des fonctions de Registre.

Syntaxe

LSTATUS RegLoadKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [in]           LPCSTR lpFile
);

Paramètres

[in] hKey

Handle de la clé dans laquelle la sous-clé sera créée. Il peut s’agir d’un handle retourné par un appel à RegConnectRegistry, ou de l’un des handles prédéfinis suivants :

HKEY_LOCAL_MACHINEHKEY_USERS Cette fonction charge toujours les informations en haut de la hiérarchie du Registre. Les valeurs de handle HKEY_CLASSES_ROOT et de HKEY_CURRENT_USER ne peuvent pas être spécifiées pour ce paramètre, car elles représentent des sous-ensembles des valeurs de handle HKEY_LOCAL_MACHINE et HKEY_USERS , respectivement.

[in, optional] lpSubKey

Nom de la clé à créer sous hKey. Cette sous-clé est l’emplacement où les informations d’inscription du fichier seront chargées.

Les noms de clés ne respectent pas la casse.

Pour plus d’informations, consultez Limites de taille des éléments de registre.

[in] lpFile

Nom du fichier contenant les données du Registre. Ce fichier doit être un fichier local qui a été créé avec la fonction RegSaveKey . Si ce fichier n’existe pas, un fichier est créé avec le nom spécifié.

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.

Remarques

Il existe deux formats de fichier Hive de Registre. Les ruches de Registre créées sur les systèmes d’exploitation actuels ne peuvent généralement pas être chargées par des ruches de registre antérieures.

Si hKey est un handle retourné par RegConnectRegistry, le chemin spécifié dans lpFile est relatif à l’ordinateur distant.

Le processus appelant doit disposer des privilèges SE_RESTORE_NAME et SE_BACKUP_NAME sur l’ordinateur sur lequel réside le Registre. Pour plus d’informations, consultez Exécution avec des privilèges spéciaux. Pour charger une ruche sans nécessiter ces privilèges spéciaux, utilisez la fonction RegLoadAppKey .

Notes

L’en-tête winreg.h définit RegLoadKey en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winreg.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll