NdisOpenConfigurationKeyByIndex-Funktion (ndis.h)
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) |