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 NetConfigurationOpenSubConfiguration geö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 eine Position, die ein Handle auf 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 entsprechenden NTSTATUS-Fehlercode zurück.
Hinweise
Wenn der Client eine WDF_OBJECT_ATTRIBUTES bereitstellt, gibt er NULL für ParentObject an. Standardmäßig ist die Unterkonfiguration dem vorhandenen Adapterkonfigurationsobjekt übergeordnet.
Der Clienttreiber schließt die Unterkonfiguration, indem netConfigurationClose entweder mit dem Unterkonfigurationsobjekt oder dem übergeordneten Adapterkonfigurationsobjekt aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.21 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netconfiguration.h (include netadaptercx.h) |
| Bibliothek | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |