NetConfigurationQueryString-Funktion (netconfiguration.h)

Artikel
05/23/2024

Ruft den angegebenen Zeichenfolgenwert aus dem Adapterkonfigurationsobjekt ab und weist die Zeichenfolge einem angegebenen Frameworkzeichenfolgenobjekt zu.

Syntax

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);

Parameter

[_In_] Configuration

Behandeln Sie ein NETCONFIGURATION-Objekt, das einen geöffneten Registrierungsschlüssel darstellt.

[_In_] ValueName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die einen Namen für den Zeichenfolgenwert enthält.

[_In_opt_] StringAttributes

Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES-Struktur , die vom Treiber bereitgestellte Attribute für das neue WDFSTRING-Objekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[_Out_] WdfString

Ein Handle für ein Frameworkzeichenfolgenobjekt. NetAdapterCx weist diesem Objekt die Zeichenfolgendaten des Registrierungswerts zu.

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

Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION-Objekt ab, indem er NetConfigurationOpenConfiguration oder NetConfigurationOpenSubConfiguration aufruft.

Standardmäßig ist das Frameworkzeichenfolgenobjekt dem Auflistungsobjekt übergeordnet. Der Clienttreiber kann dies ändern, indem er das ParentObject-Element der WDF_OBJECT_ATTRIBUTES-Struktur festlegt.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.21
UMDF-Mindestversion	2.33
Kopfzeile	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Freigeben über