NetConfigurationQueryMultiString 函式 (netconfiguration.h)

擷取與指定組態物件中值名稱相關聯的 MultiString 值登錄專案。

語法

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

參數

[_In_] Configuration

表示已開啟登錄機碼的 NETCONFIGURATION 物件句柄。

[_In_] ValueName

UNICODE_STRING 結構的指標 ，其中包含裝置軟體密鑰中的值名稱。

[_In_opt_] StringsAttributes

WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新 WDFSTRING 對象的驅動程式提供屬性。 此參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[_Inout_] Collection

驅動程式提供的集合物件的句柄。 如果函式成功，則包含指派給 ValueName 之每個字串的 WDFSTRING 物件。

傳回值

如果作業成功，函式會傳回STATUS_SUCCESS。 如果登錄值為 NULL，NetConfigurationQueryMultiString 會傳回 STATUS_OBJECT_NAME_NOT_FOUND。

備註

用戶端驅動程式會呼叫 NetAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration，以取得 NETCONFIGURATION 物件的句柄。

根據預設，字串會父代至集合物件。 用戶端驅動程式可以藉由設定 WDF_OBJECT_ATTRIBUTES 結構的 ParentObject 成員來變更此專案。

規格需求

需求	值
目標平台	Universal
最小 KMDF 版本	1.21
最低UMDF版本	2.33
標頭	netconfiguration.h (包含 netadaptercx.h)
程式庫	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL