NetConfigurationQueryString 函数 (netconfiguration.h)

从适配器配置对象中检索指定的字符串值,并将该字符串分配给指定的框架字符串对象。

语法

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);

参数

[_In_] Configuration

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

[_In_] ValueName

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

[_In_opt_] StringAttributes

指向 WDF_OBJECT_ATTRIBUTES 结构的指针,该结构包含驱动程序为新的 WDFSTRING 对象提供的属性。 此参数是可选的,可以WDF_NO_OBJECT_ATTRIBUTES。

[_Out_] WdfString

框架字符串对象的句柄。 NetAdapterCx 会将注册表值的字符串数据分配给此对象。

返回值

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

注解

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

默认情况下,框架字符串对象为集合对象的父级。 客户端驱动程序可以通过设置 WDF_OBJECT_ATTRIBUTES 结构的 ParentObject 成员来更改此设置。

要求

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