NdisOpenConfigurationKeyByIndex-Funktion (ndis.h)

Artikel
03/01/2024

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

Syntax

void NdisOpenConfigurationKeyByIndex(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  ULONG        Index,
  [out] PNDIS_STRING KeyName,
  [out] PNDIS_HANDLE KeyHandle
);

Parameter

[out] Status

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

NDIS_STATUS_SUCCESS

NDIS hat den Zugriff auf den durch KeyName und Index 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 von zurückgegeben. NdisOpenConfigurationEx-Funktion .

[in] Index

Der Index des zu öffnenden Unterschlüssels. Dieser nullbasierte Wert gibt den Unterschlüssel an, der unter dem Schlüssel geöffnet werden soll, der bereits mit ConfigurationHandle geöffnet wurde.

[out] KeyName

Ein Zeiger auf einen NDIS_STRING Typ, der einen vom Aufrufer bereitgestellten Puffer enthält, in dem diese Funktionen eine gezählte Zeichenfolge im Systemstandardzeichensatz zurückgeben. Diese Zeichenfolge gibt den Namen des geöffneten Unterschlüssels an, wenn der Aufruf erfolgreich ist. 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] KeyHandle

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

Rückgabewert

Keine

Bemerkungen

NdisOpenConfigurationKeyByIndex ermöglicht einem Treiber den Zugriff auf Konfigurationsinformationen, die seine Installationsdatei in einem Registrierungsunterschlüssel gespeichert hat.

Beachten Sie, dass die an NdisOpenConfigurationKeyByIndex übergebene ConfigurationHandle ein beliebiges gültiges Handle für einen Registrierungsschlüssel sein kann, der bereits vom Aufrufer geöffnet wurde. NdisOpenConfigurationKeyByIndex gibt Konfigurationsinformationen für Unterschlüssel im Verhältnis zu allen gültigen Zurück.
ConfigurationHandle .

Da NdisOpenConfigurationKeyByIndex auf einen Unterschlüssel über einen Index verweist, muss der Treiber keine Unterschlüsselnamen angeben. Ein Treiber kann durch eine Reihe von Registrierungsunterschlüsseln sequenzieren, indem er wiederholt NdisOpenConfigurationKeyIndex aufruft, nachdem der Index erhöht wurde, bis die Funktion NDIS_STATUS_FAILURE zurückgibt, wodurch angegeben wird, dass keine Weiteren Unterschlüssel geöffnet werden können.

Nachdem ein Treiber die in der Registrierung gespeicherten Konfigurationsinformationen verbraucht und möglicherweise geändert hat, muss er die NdisCloseConfiguration-Funktion aufrufen, um das Handle freizugeben, das aus NdisOpenConfigurationKeyByIndex abgerufen wird. NdisCloseConfiguration gibt auch den temporären Speicher frei, den NDIS für die Aufrufe der Funktionen NdisReadConfiguration, NdisReadNetworkAddress oder NdisWriteConfiguration mit der SubKeyHandle zugewiesen hat, die von NdisOpenConfigurationKeyByIndex zurückgegeben wurde.

Anforderungen

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