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