OROpenHive-Funktion
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 |
|
| DLL |
|
Weitere Informationen