Skip to content

Latest commit

 

History

History
77 lines (58 loc) · 2.63 KB

nf-netconfiguration-netconfigurationquerystring.md

File metadata and controls

77 lines (58 loc) · 2.63 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.alt-api req.alt-loc targetos f1_keywords topic_type api_type api_location api_name
NF:netconfiguration.NetConfigurationQueryString
NetConfigurationQueryString function (netconfiguration.h)
Retrieves the specified string value from the adapter configuration object and assigns the string to a specified framework string object.
netvista
03/30/2022
NetConfigurationQueryString function
NetConfigurationQueryString
netconfiguration.h
netadaptercx.h
Universal
1.21
PASSIVE_LEVEL
Windows
NetConfigurationQueryString
netconfiguration/NetConfigurationQueryString
apiref
HeaderDef
netconfiguration.h
NetConfigurationQueryString

NetConfigurationQueryString function

-description

Retrieves the specified string value from the adapter configuration object and assigns the string to a specified framework string object.

-parameters

-param Configuration [In]

Handle to a NETCONFIGURATION object that represents an opened registry key.

-param ValueName [In]

A pointer to a UNICODE_STRING structure that contains a name for string value.

-param StringAttributes [In_opt]

A pointer to a WDF_OBJECT_ATTRIBUTES structure that contains driver-supplied attributes for the new WDFSTRING object. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.

-param WdfString [Out]

A handle to a framework string object. NetAdapterCx will assign the registry value's string data to this object.

-returns

The function returns STATUS_SUCCESS if the operation succeeds. Otherwise, this function may return an appropriate NTSTATUS error code.

-remarks

The client driver obtains a handle to a NETCONFIGURATION object by calling NetAdapterOpenConfiguration or NetConfigurationOpenSubConfiguration.

By default, the framework string object is parented to the collection object. The client driver can change this by setting the ParentObject member of the WDF_OBJECT_ATTRIBUTES structure.

-see-also