Compartilhar via

Função NetConfigurationQueryString (netconfiguration.h)

  • Artigo

Recupera o valor de cadeia de caracteres especificado do objeto de configuração do adaptador e atribui a cadeia de caracteres a um objeto de cadeia de caracteres de estrutura especificado.

Sintaxe

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

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 para o valor da cadeia de caracteres.

[_In_opt_] StringAttributes

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

[_Out_] WdfString

Um identificador para um objeto de cadeia de caracteres de estrutura. NetAdapterCx atribuirá os dados de cadeia de caracteres do valor do Registro a esse objeto.

Retornar valor

A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função poderá retornar um código de erro NTSTATUS apropriado.

Comentários

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

Por padrão, o objeto de cadeia de caracteres da estrutura é pai do objeto de 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 (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL