Compartir a través de

Función NetConfigurationQueryMultiString (netconfiguration.h)

  • Artículo

Recupera la entrada del Registro con valores MultiString asociada a un nombre de valor en el objeto de configuración especificado.

Sintaxis

NTSTATUS NetConfigurationQueryMultiString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringsAttributes,
  [_Inout_]  WDFCOLLECTION         Collection
);

Parámetros

[_In_] Configuration

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

[_In_] ValueName

Puntero a una estructura UNICODE_STRING que contiene un nombre de valor en la clave de software del dispositivo.

[_In_opt_] StringsAttributes

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

[_Inout_] Collection

Identificador de un objeto de colección proporcionado por el controlador. Si la función se ejecuta correctamente, contiene un objeto WDFSTRING para cada cadena asignada a ValueName.

Valor devuelto

La función devuelve STATUS_SUCCESS si la operación se realiza correctamente. Si el valor del Registro es NULL, NetConfigurationQueryMultiString devuelve STATUS_OBJECT_NAME_NOT_FOUND.

Comentarios

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

De forma predeterminada, las cadenas están primarias 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)
Library NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL