通过

NetConfigurationAssignMultiString 函数 （netconfiguration.h）

  • 项目

NetConfigurationAssignMultiString 函数将一组字符串分配给注册表中的指定值名称。 字符串包含在框架字符串对象的指定集合中。

语法

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

参数

[_In_] Configuration

表示已打开的注册表项的 NETCONFIGURATION 对象的句柄。

[_In_] ValueName

指向包含值名称的 UNICODE_STRING 结构的指针。

[_In_] Collection

表示框架字符串对象的集合的框架集合对象的句柄。

返回值

如果作成功，此函数将返回STATUS_SUCCESS。 否则，此函数可能会返回相应的 NTSTATUS 错误代码。

言论

客户端驱动程序通过调用 netAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration来获取 NETCONFIGURATION 对象的句柄。

如果打开的注册表项下已存在与 ValueName 相同的项，NetConfigurationAssignMultiString 将其当前值替换为调用方提供的值。 否则，NetConfigurationAssignMultiString 将具有给定名称的新值项和提供的值添加到注册表。

要求

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