NetConfigurationOpenSubConfiguration-Funktion (netconfiguration.h)

  • Artikel

Ö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
Kopfzeile netconfiguration.h (include netadaptercx.h)
Bibliothek NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration