NetConfigurationQueryString - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// netconfiguration.h

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-netconfiguration-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

Configuration [_In_]

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

ValueName [_In_]

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

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.

WdfString [_Out_]

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

Return value

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