NetConfigurationQueryMultiString-Funktion (netconfiguration.h)

Ruft den Registrierungseintrag "MultiString-Wert" 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

Behandeln Sie 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 das WDFSTRING-Objekt für jede Zeichenfolge, die ValueNamezugewiesen 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_FOUNDzurück.

Bemerkungen

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

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

Anforderungen