ORCreateHive-Funktion
Erstellt eine Offlineregistrierungsstruktur, die einen einzelnen leeren Stammschlüssel enthält.
Syntax
DWORD ORCreateHive(
_Out_ PORHKEY phkResult
);
Parameter
-
phkResult [out]
-
Zeigt auf eine Variable, um ein Handle für den Stammschlüssel der neu erstellten Offlineregistrierungsstruktur zu erhalten. Wenn die Struktur nicht erstellt werden kann, 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 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.
Wenn nicht genügend Arbeitsspeicher zum Erstellen der Registrierungsstruktur vorhanden ist, gibt die Funktion ERROR_NOT_ENOUGH_MEMORY zurück.
Bemerkungen
Die ORCreateHive-Funktion erstellt eine leere Offlineregistrierungsstruktur im Arbeitsspeicher. Verwenden Sie die Funktionen ORCreateKey und ORSetValue , um Schlüssel hinzuzufügen und deren Werte festzulegen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Verteilbare Komponente |
Windows-Offlineregistrierungsbibliothek Version 1.0 oder höher |
| Header |
|
| DLL |
|
Siehe auch