Función NetConfigurationQueryMultiString (netconfiguration.h)

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 de UNICODE_STRING que contiene un nombre de valor en la clave de software del dispositivo.

[_In_opt_] StringsAttributes

Puntero a una estructura de 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.

Observaciones

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 cliente puede cambiarlo estableciendo el miembro ParentObject de la estructura de WDF_OBJECT_ATTRIBUTES.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.21
versión mínima de UMDF	2.33
encabezado de	netconfiguration.h (include netadaptercx.h)
biblioteca de	NetAdapterCxStub.lib
irQL	PASSIVE_LEVEL