RegLoadKeyA-Funktion (winreg.h)

Artikel
03/06/2024

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 Registrierungsstrukturen, sollten anstelle der Registrierungsfunktionen den Volume Shadow Copy Service 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 durch einen Aufruf von RegConnectRegistry zurückgegeben wird, oder eines der folgenden vordefinierten Handles:

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

[in, optional] lpSubKey

Der Name des Schlüssels, der unter hKey erstellt werden soll. In diesem Unterschlüssel werden die Registrierungsinformationen aus der Datei geladen.

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

Weitere Informationen finden Sie unter Größenbeschränkungen für Registrierungselemente.

[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 flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Hinweise

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

Wenn hKey ein von RegConnectRegistry zurückgegebenes Handle ist, ist der in lpFile angegebene Pfad relativ zum Remotecomputer.

Der aufrufende Prozess 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 Berechtigungen. Um eine Struktur ohne diese besonderen Berechtigungen zu laden, verwenden Sie die RegLoadAppKey-Funktion .

Hinweis

Der winreg.h-Header definiert RegLoadKey als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winreg.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll