NetConfigurationQueryString-Funktion (netconfiguration.h)

Artikel
02/07/2025

Ruft den angegebenen Zeichenfolgenwert aus dem Adapterkonfigurationsobjekt ab und weist die Zeichenfolge einem angegebenen Framework-Zeichenfolgenobjekt 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 zu einem Framework-Zeichenfolgenobjekt. 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 geeigneten NTSTATUS-Fehlercode zurück.

Bemerkungen

Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION -Objekt ab, indem NetAdapterOpenConfiguration oder NetConfigurationOpenSubConfigurationaufgerufen wird.

Standardmäßig wird das Framework-Zeichenfolgenobjekt dem Auflistungsobjekt übergeordnet. Der Clienttreiber kann dies ändern, indem das ParentObject Member der WDF_OBJECT_ATTRIBUTES-Struktur festgelegt wird.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.21
Mindest-UMDF-Version	2.33
Header-	netconfiguration.h (include netadaptercx.h)
IRQL-	PASSIVE_LEVEL

Freigeben über