通过

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 成员来更改此设置。

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.21
最低 UMDF 版本 2.33
标头 netconfiguration.h （包括 netadaptercx.h）
库 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL