NetConfigurationOpenSubConfiguration-Funktion (netconfiguration.h)
Öffnet eine Unterkonfiguration eines angegebenen Adapterkonfigurationsobjekts.
Syntax
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
Parameter
[_In_] Configuration
Ein Handle für ein Adapterkonfigurationsobjekt, das in einem vorherigen Aufruf von NetAdapterOpenConfiguration oder NetConfigurationOpenSubConfigurationgeöffnet wurde.
[_In_] SubConfigurationName
Ein Zeiger auf eine Zeichenfolge, die den Namen der zu öffnenden Unterkonfiguration angibt.
[_In_opt_] SubConfigurationAttributes
Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES Struktur, die vom Treiber bereitgestellte Attribute für das neue Konfigurationsobjekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.
[_Out_] SubConfiguration
Ein Zeiger auf einen Speicherort, der ein Handle für das neue Unterkonfigurationsobjekt empfängt.
Rückgabewert
Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.
Bemerkungen
Wenn der Client eine WDF_OBJECT_ATTRIBUTESbereitstellt, gibt er NULL- für ParentObject-an. Standardmäßig wird die Unterkonfiguration mit dem vorhandenen Adapterkonfigurationsobjekt verknüpft.
Der Clienttreiber schließt die Unterkonfiguration, indem NetConfigurationClose- mit dem Unterkonfigurationsobjekt oder dem übergeordneten Adapterkonfigurationsobjekt aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.21 |
| Mindest-UMDF-Version | 2.33 |
| Header- | netconfiguration.h (include netadaptercx.h) |
| Library | NetAdapterCxStub.lib |
| IRQL- | PASSIVE_LEVEL |