NdisOpenConfigurationKeyByName-Funktion (ndis.h)

Artikel
08/07/2023

Die NdisOpenConfigurationKeyByName-Funktion öffnet einen benannten Unterschlüssel eines angegebenen geöffneten Registrierungsschlüssels, der von einem vom Aufrufer bereitgestellten Handle festgelegt wird.

Syntax

void NdisOpenConfigurationKeyByName(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  PNDIS_STRING SubKeyName,
  [out] PNDIS_HANDLE SubKeyHandle
);

Parameter

[out] Status

Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion den status ihres Versuchs zurückgibt, den Registrierungsschlüssel zu öffnen. Mögliche Rückgabewerte sind einer der folgenden:

NDIS_STATUS_SUCCESS

NDIS hat den Zugriff auf den durch SubKeyName angegebenen Unterschlüssel initialisiert.

NDIS_STATUS_FAILURE

Der Schlüssel konnte nicht geöffnet werden.

[in] ConfigurationHandle

Das Handle für einen Registrierungsschlüssel, für den ein Unterschlüssel geöffnet werden soll. In der Regel wird ConfigurationHandle vom NdisOpenConfigurationEx-Funktion .

[in] SubKeyName

Ein Zeiger auf einen NDIS_STRING-Typ, der eine vom Aufrufer bereitgestellte, gezählte Zeichenfolge im Systemstandardzeichensatz enthält, der den Namen des zu öffnenden Registrierungsunterschlüssels angibt. Bei Treibern von Microsoft Windows 2000 und höher enthält diese Zeichenfolge Unicode-Zeichen. Das heißt, für Windows 2000 und höher definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING-Typ .

[out] SubKeyHandle

Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion ein Handle an den geöffneten Unterschlüssel zurückgibt, wenn dieser Aufruf erfolgreich ist.

Rückgabewert

Keine

Bemerkungen

NdisOpenConfigurationKeyByName ermöglicht einem Treiber den Zugriff auf Konfigurationsinformationen, die in einem benannten Unterschlüssel in der Registrierung gespeichert sind.

Beachten Sie, dass das an NdisOpenConfigurationKeyByName übergebene ConfigurationHandle ein beliebiges gültiges Handle für einen Registrierungsschlüssel sein kann, der bereits vom Aufrufer geöffnet wurde. NdisOpenConfigurationKeyByName gibt Konfigurationsinformationen für Unterschlüssel relativ zu jedem gültigen ConfigurationHandle zurück.

Nachdem ein Treiber die Registrierungskonfigurationsinformationen verbraucht und möglicherweise geändert hat, muss er die NdisCloseConfiguration-Funktion aufrufen, um das handle freizugeben, das von NdisOpenConfigurationKeyByName abgerufen wurde. NdisCloseConfiguration gibt auch jeden temporären Speicher frei, den NDIS in den Aufrufen des Treibers für die Funktionen NdisReadConfiguration, NdisReadNetworkAddress oder NdisWriteConfiguration mit der SubKeyHandle zugewiesen hat, die von NdisOpenConfigurationKeyByName zurückgegeben wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisOpenConfigurationKeyByName (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisOpenConfigurationKeyByName (NDIS 5.1)) in Windows XP.
Zielplattform	Universell
Header	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	< DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis)