通过

NetConfigurationQueryBinary 函数 （netconfiguration.h）

  • 项目

检索当前分配给指定注册表值的数据，将数据存储在框架分配的缓冲区中，并创建一个框架内存对象来表示缓冲区。

语法

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

参数

[_In_] Configuration

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

[_In_] ValueName

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

[_In_] PoolType

一个 POOL_TYPE类型化值，指定要为数据缓冲区分配的内存类型。

[_In_opt_] MemoryAttributes

指向包含新内存对象的对象属性的 WDF_OBJECT_ATTRIBUTES 结构的指针。 此参数是可选的，可以 WDF_NO_OBJECT_ATTRIBUTES。

[_Out_] Memory

指向接收新内存对象的句柄的位置的指针。 框架分配此内存缓冲区，并在 NETCONFIGURATION 对象关闭时自动释放该缓冲区。

返回值

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

言论

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

关闭 NETCONFIGURATION 对象时，框架会自动释放此函数分配的内存。

要求

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