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

Siehe auch

ORCloseKey

ORCreateKey

ORDeleteKey

OROpenHive