Función NetConfigurationQueryString (netconfiguration.h)

Recupera el valor de cadena especificado del objeto de configuración del adaptador y asigna la cadena a un objeto de cadena de marco especificado.

Sintaxis

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

Parámetros

[_In_] Configuration

Identificador de un objeto NETCONFIGURATION que representa una clave del Registro abierta.

[_In_] ValueName

Puntero a una estructura de UNICODE_STRING que contiene un nombre para el valor de cadena.

[_In_opt_] StringAttributes

Puntero a una estructura WDF_OBJECT_ATTRIBUTES que contiene atributos proporcionados por el controlador para el nuevo objeto WDFSTRING. Este parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] WdfString

Identificador de un objeto de cadena de marco. NetAdapterCx asignará los datos de cadena del valor del Registro a este objeto.

Valor devuelto

La función devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.

Comentarios

El controlador cliente obtiene un identificador para un objeto NETCONFIGURATION llamando a NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.

De forma predeterminada, el objeto de cadena de marco está primario en el objeto de colección. El controlador de cliente puede cambiarlo estableciendo el miembro ParentObject de la estructura WDF_OBJECT_ATTRIBUTES .

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.21
Encabezado	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL