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 |
|
| DLL |
|