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 den gleichen Handle zurück, der übergeben wurde. Wenn der durch den 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 auf den geöffneten Schlüssel empfängt. Verwenden Sie die ORCloseKey-Funktion , um den Schlüssel zu schließen, nachdem Sie die Verwendung des Handles abgeschlossen haben.
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 das zurückzugebende Handle ein Handle für den Stammschlüssel der Struktur ist, 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.
Bemerkungen
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-Offlineregistrierungsbibliothek Version 1.0 oder höher |
| Header |
|
| DLL |
|
Siehe auch