OROpenHive-Funktion

  • Artikel

Lädt die angegebene Registrierungsstrukturdatei in den Arbeitsspeicher und überprüft die Struktur.

Syntax

DWORD OROpenHive(
  _In_  PCWSTR  lpHivePath,
  _Out_ PORHKEY phkResult
);

Parameter

lpHivePath [in]

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen der Registrierungsstrukturdatei angibt, die in den Arbeitsspeicher geladen werden soll. Dies kann eine Hive-Datei sein, die mit der ORSaveHive-Funktion gespeichert oder mit der RegSaveKey- oder RegSaveKeyEx-Funktion erstellt wurde. Die Datei muss kleiner als 4 GB sein, und der Aufrufer muss FILE_READ_DATA Zugriff auf die Datei haben. Weitere Informationen finden Sie unter Dateisicherheit und Zugriffsrechte.

phkResult [out]

Ein Zeiger auf eine Variable, die ein Handle für den Stammschlüssel der geladenen Offlineregistrierungsstruktur empfängt. Wenn die Registrierungsstrukturdatei nicht geöffnet werden kann oder die Überprüfung fehlschlägt, legt die Funktion diesen Parameter auf NULL fest.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in Winerror.h definierter Fehlercode ungleich null. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen. Mögliche Fehlercodes sind:

  • Wenn die Datei leer oder größer als 4 GB ist, gibt die Funktion ERROR_BADDB zurück.
  • Wenn der Aufrufer nicht über die erforderlichen Zugriffsrechte zum Öffnen der Datei verfügt, gibt die Funktion ERROR_ACCESS_DENIED zurück.
  • Wenn die Überprüfung der Registrierungsstruktur fehlschlägt, gibt die Funktion ERROR_NOT_REGISTRY_FILE zurück.

Bemerkungen

Die OROpenHive-Funktion ist die einzige Offlineregistrierungsfunktion, die eine Registrierungsstruktur überprüft. Wenn die Überprüfung fehlschlägt, wird kein Versuch unternommen, die Struktur zu reparieren.

Anforderungen

Anforderung Wert
Verteilbare Komponente
 Windows-Offlineregistrierungsbibliothek, Version 1.0 oder höher
Header
Offreg.h
DLL
Offreg.dll

Weitere Informationen

ORCloseHive

ORCreateHive

ORSaveHive

RegSaveKey

RegSaveKeyEx