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	Offreg.h
DLL	Offreg.dll

Siehe auch

ORCreateKey

OROpenHive

ORSaveHive

ORSetValue