NdisOpenConfigurationKeyByIndex-Funktion (ndis.h)
Die NdisOpenConfigurationKeyByIndex--Funktion öffnet einen Unterschlüssel eines bestimmten geöffneten Registrierungsschlüssels, der durch ein vom Aufrufer bereitgestelltes 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 des Versuchs zurückgibt, den angegebenen Registrierungsschlüssel zu öffnen. Mögliche Rückgabewerte sind eine der folgenden:
NDIS_STATUS_SUCCESS
NDIS hat den Zugriff auf den Unterschlüssel initialisiert, der durch KeyName- und Index- angegeben wurde.
NDIS_STATUS_FAILURE
Der Schlüssel konnte nicht geöffnet werden.
[in] ConfigurationHandle
Das Handle zu einem Registrierungsschlüssel, für den ein Unterschlüssel geöffnet werden soll. In der Regel wird ConfigurationHandle- von der NdisOpenConfigurationEx--Funktion.
[in] Index
Der Index des zu öffnenden Unterschlüssels. Dieser nullbasierte Wert legt den Unterschlüssel fest, der unter dem Schlüssel geöffnet werden soll, der bereits mit ConfigurationHandle geöffnet wird.
[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ückgibt. Diese Zeichenfolge gibt den Namen des geöffneten Unterschlüssels an, wenn der Aufruf erfolgreich ist. Für Microsoft Windows 2000 und höhere Treiber enthält diese Zeichenfolge Unicode-Zeichen. 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 verläuft.
Rückgabewert
Nichts
Bemerkungen
NdisOpenConfigurationKeyByIndex- ermöglicht einem Treiber den Zugriff auf Konfigurationsinformationen, die die Installationsdatei in einem Registrierungsunterschlüssel gespeichert hat.
Beachten Sie, dass die ConfigurationHandle- an NdisOpenConfigurationKeyByIndex 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 relativ zu jedem gültigen Wert 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 sequenziert werden, indem wiederholt NdisOpenConfigurationKeyIndex aufgerufen wird, nachdem der Index erhöht wurde, bis die Funktion NDIS_STATUS_FAILURE zurückgibt, wodurch angegeben wird, dass keine weiteren Unterschlüssel zum Öffnen vorhanden sind.
Nachdem ein Treiber die in der Registrierung gespeicherten Konfigurationsinformationen genutzt und möglicherweise geändert hat, muss er die NdisCloseConfiguration--Funktion aufrufen, um das Handle freizugeben, das von NdisOpenConfigurationKeyByIndexabgerufen wird. NdisCloseConfiguration gibt auch alle temporären Speicher frei, die NDIS für die Aufrufe des Treibers an die NdisReadConfiguration, NdisReadNetworkAd zugewiesen wurde.oder NdisWriteConfiguration Funktionen mit der SubKeyHandle-, die NdisOpenConfigurationKeyByIndex zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | < DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |