OROpenKey-Funktion

Öffnet den angegebenen Registrierungsschlüssel in einer Offlineregistrierungsstruktur.

Syntax

DWORD OROpenKey(
  _In_     ORHKEY  Handle,
  _In_opt_ PCWSTR  lpSubKeyName,
  _Out_    PORHKEY phkResult
);

Parameter

Handle [ In]

Ein Handle für einen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur.

lpSubKeyName [ in, optional]

Ein Zeiger auf eine UNICODE-Zeichenfolge, die den Namen des zu öffnenden Registrierungsschlüssels enthält. Dieser Schlüssel muss ein Unterschlüssel des Schlüssels sein, der durch den Handle-Parameter identifiziert wird.

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

Wenn dieser Parameter NULL oder ein Zeiger auf eine leere Zeichenfolge ist, gibt die Funktion das gleiche Handle zurück, das übergeben wurde. Wenn der vom Handle-Parameter angegebene Schlüssel der Stammschlüssel der Struktur ist, gibt die Funktion ERROR _ INVALID PARAMETER _ zurück.

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

phkResult [ out]

Ein Zeiger auf eine Variable, die ein Handle für den geöffneten Schlüssel empfängt. Verwenden Sie die ORCloseKey-Funktion, um den Schlüssel zu schließen, nachdem Sie das Handle verwendet haben.

Rückgabewert

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert ERROR _ SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode ungleich 0 (null), der in Winerror.h definiert ist. Sie können die FormatMessage-Funktion mit dem _ FORMAT MESSAGE FROM _ _ SYSTEM-Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Wenn das zurückzugebende Handle ein Handle für den Stammschlüssel der Struktur wäre, gibt die Funktion ERROR _ INVALID _ PARAMETER zurück.

Wenn der angegebene Schlüssel als gelöscht markiert wurde, gibt diese Funktion ERROR _ KEY _ DELETED zurück.

Hinweise

Die OROpenKey-Funktion kann nicht verwendet werden, um den Stammschlüssel in einer Offlineregistrierungsstruktur zu öffnen. Um ein Handle für den Stammschlüssel einer Struktur abzurufen, verwenden Sie die OROpenHive-Funktion, um die Struktur in den Arbeitsspeicher zu laden.

Anforderungen

Anforderung Wert
Verteilbare Komponente
Windows Offline registry library version 1.0 or later (Offlineregistrierungsbibliothek, Version 1.0 oder höher)
Header
Offreg.h
DLL
Offreg.dll

Weitere Informationen

ORCloseKey

ORCreateKey

ORDeleteKey

OROpenHive