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 zu einem 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 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_ATTRIBUTES bereitstellt, 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 entweder mit dem Unterkonfigurationsobjekt oder dem übergeordneten Adapterkonfigurationsobjekt aufgerufen wird.

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.21
Minimale UMDF-Version	2.33
Kopfball	netconfiguration.h (include netadaptercx.h)
Bibliothek	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Siehe auch

NetAdapterOpenConfiguration