NdisOpenConfigurationKeyByName-Funktion (ndis.h)
Die NdisOpenConfigurationKeyByName-Funktion öffnet einen benannten Unterschlüssel eines bestimmten 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 des Versuchs zurückgibt, den 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 SubKeyName 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] SubKeyName
Ein Zeiger auf einen NDIS_STRING Typ mit einer vom Aufrufer bereitgestellten, gezählten Zeichenfolge im Systemstandardzeichensatz, der den Namen des zu öffnenden Registrierungsunterschlüssels angibt. 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] 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
Nichts
Bemerkungen
NdisOpenConfigurationKeyByName ermöglicht einem Treiber den Zugriff auf Konfigurationsinformationen, die in einem benannten Unterschlüssel in der Registrierung gespeichert sind.
Beachten Sie, dass die ConfigurationHandle- an NdisOpenConfigurationKeyByName ein beliebiges gültiges Handle für einen Registrierungsschlüssel sein kann, der bereits vom Aufrufer geöffnet wurde. NdisOpenConfigurationKeyByName Konfigurationsinformationen für Unterschlüssel relativ zu allen 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 NdisOpenConfigurationKeyByNameabgerufen wurde. NdisCloseConfiguration gibt auch alle temporären Speicher frei, die NDIS in den Aufrufen des Treibers an die NdisReadConfiguration, NdisReadNetworkAddressoder NdisWriteConfiguration Funktionen mit der SubKeyHandle-, die NdisOpenConfigurationKeyByName zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | < DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |