NetConfigurationQueryString-Funktion (netconfiguration.h)
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
Handle für 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 geeigneten NTSTATUS-Fehlercode zurück.
Hinweise
Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION-Objekt ab, indem er NetAdapterOpenConfiguration oder NetConfigurationOpenSubConfiguration aufruft.
Standardmäßig wird das Frameworkzeichenfolgenobjekt dem Auflistungsobjekt übergeordnet. Der Clienttreiber kann dies ändern, indem er den ParentObject-Member der WDF_OBJECT_ATTRIBUTES-Struktur festlegt.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.21 |
Kopfzeile | netconfiguration.h (include netadaptercx.h) |
IRQL | PASSIVE_LEVEL |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für