netConfigurationAssignBinary 函数 (netconfiguration.h)

NetConfigurationAssignBinary 函数将调用方提供的二进制数据写入注册表中的指定值名称。

语法

NTSTATUS NetConfigurationAssignBinary(
  [_In_]                             NETCONFIGURATION Configuration,
  [_In_]                             PCUNICODE_STRING ValueName,
  [__In_reads_bytes_(BufferLength)_] void             *Buffer,
  [_In_]                             ULONG            BufferLength
);

参数

[_In_] Configuration

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

[_In_] ValueName

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

[__In_reads_bytes_(BufferLength)_] Buffer

指向包含驱动程序提供的数据的缓冲区的指针。

[_In_] BufferLength

Buffer 指向的缓冲区的长度(以字节为单位)。

返回值

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

注解

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

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

要求

要求
目标平台 通用
最低 KMDF 版本 1.21
最低 UMDF 版本 2.33
标头 netconfiguration.h (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL