RegLoadKeyA-Funktion (winreg.h)

Erstellt einen Unterschlüssel unter HKEY_USERS oder HKEY_LOCAL_MACHINE und lädt die Daten aus der angegebenen Registrierungsstruktur in diesen Unterschlüssel.

Anwendungen, die den Systemstatus sichern oder wiederherstellen, einschließlich Systemdateien und Registrierungsstruktur, sollten den Volume Shadow Copy Service anstelle der Registrierungsfunktionen verwenden.

Syntax

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

Parameter

[in] hKey

Ein Handle für den Schlüssel, in dem der Unterschlüssel erstellt wird. Dies kann ein Handle sein, das von einem Aufruf von RegConnectRegistryoder einem der folgenden vordefinierten Handles zurückgegeben wird:

HKEY_LOCAL_MACHINEHKEY_USERS Diese Funktion lädt immer Informationen oben in der Registrierungshierarchie. Die HKEY_CLASSES_ROOT- und HKEY_CURRENT_USER Handlewerte können für diesen Parameter nicht angegeben werden, da sie Teilmengen der HKEY_LOCAL_MACHINE bzw. HKEY_USERS Behandeln von Werten darstellen.

[in, optional] lpSubKey

Der Name des zu erstellenden Schlüssels unter hKey-. Dieser Unterschlüssel ist der Ort, an dem die Registrierungsinformationen aus der Datei geladen werden.

Bei Schlüsselnamen wird die Groß-/Kleinschreibung nicht beachtet.

Weitere Informationen finden Sie unter Registrierungselementgrößenbeschränkungen.

[in] lpFile

Der Name der Datei, die die Registrierungsdaten enthält. Diese Datei muss eine lokale Datei sein, die mit der RegSaveKey--Funktion erstellt wurde. Wenn diese Datei nicht vorhanden ist, wird eine Datei mit dem angegebenen Namen erstellt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist. Sie können die FormatMessage--Funktion mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine allgemeine Beschreibung des Fehlers zu erhalten.

Bemerkungen

Es gibt zwei Registrierungsstrukturdateiformate. Registrierungsstrukturen, die auf aktuellen Betriebssystemen erstellt wurden, können in der Regel nicht von früheren geladen werden.

Wenn hKey- ein Handle ist, das von RegConnectRegistryzurückgegeben wird, ist der in lpFile- angegebene Pfad relativ zum Remotecomputer.

Der Aufrufvorgang muss über die SE_RESTORE_NAME und SE_BACKUP_NAME Berechtigungen auf dem Computer verfügen, auf dem sich die Registrierung befindet. Weitere Informationen finden Sie unter Ausführen mit speziellen Rechten. Um eine Struktur zu laden, ohne diese speziellen Berechtigungen zu benötigen, verwenden Sie die RegLoadAppKey--Funktion.

Anforderungen

Siehe auch

RegConnectRegistry-

RegDeleteKey-

RegLoadAppKey-

RegReplaceKey-

RegRestoreKey-

RegSaveKey-

RegUnLoadKey-

Registrierungsfunktionen

Registrierungsstruktur