NetConfigurationQueryMultiString-Funktion (netconfiguration.h)

  • Artikel

Ruft den Registrierungseintrag multiString-valued ab, der einem Wertnamen im angegebenen Konfigurationsobjekt zugeordnet ist.

Syntax

NTSTATUS NetConfigurationQueryMultiString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringsAttributes,
  [_Inout_]  WDFCOLLECTION         Collection
);

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 Wertnamen im Softwareschlüssel des Geräts enthält.

[_In_opt_] StringsAttributes

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

[_Inout_] Collection

Ein Handle für ein vom Treiber bereitgestelltes Auflistungsobjekt. Wenn die Funktion erfolgreich ist, enthält ein WDFSTRING-Objekt für jede Zeichenfolge, die ValueName zugewiesen ist.

Rückgabewert

Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Wenn der Registrierungswert NULL ist, gibt NetConfigurationQueryMultiStringSTATUS_OBJECT_NAME_NOT_FOUND zurück.

Hinweise

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

Standardmäßig werden die Zeichenfolgen 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)
Bibliothek NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL