Compartir a través de

Función NetConfigurationQueryString (netconfiguration.h)

  • Artículo

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
Versión mínima de UMDF 2,33
Encabezado netconfiguration.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL