Função NetConfigurationQueryMultiString (netconfiguration.h)

Recupera a entrada do Registro com valor MultiString associada a um nome de valor no objeto de configuração especificado.

Sintaxe

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

Parâmetros

[_In_] Configuration

Manipule para um objeto NETCONFIGURATION que representa uma chave do Registro aberta.

[_In_] ValueName

Um ponteiro para uma estrutura UNICODE_STRING que contém um nome de valor na chave de software do dispositivo.

[_In_opt_] StringsAttributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos fornecidos pelo driver para os novos objetos WDFSTRING. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[_Inout_] Collection

Um identificador para um objeto de coleção fornecido pelo driver. Se a função for bem-sucedida, conterá um objeto WDFSTRING para cada cadeia de caracteres atribuída a ValueName.

Retornar valor

A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Se o valor do Registro for NULL, NetConfigurationQueryMultiString retornará STATUS_OBJECT_NAME_NOT_FOUND.

Comentários

O driver cliente obtém um identificador para um objeto NETCONFIGURATION chamando NetAdapterOpenConfiguration ou NetConfigurationOpenSubConfiguration.

Por padrão, as cadeias de caracteres são pai do objeto da coleção. O driver do cliente pode alterar isso definindo o membro ParentObject da estrutura WDF_OBJECT_ATTRIBUTES .

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.21
Versão mínima do UMDF	2.33
Cabeçalho	netconfiguration.h (include netadaptercx.h)
Biblioteca	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL