Função NetConfigurationQueryBinary (netconfiguration.h)

Artigo
02/07/2025

Recupera os dados atribuídos atualmente a um valor de registro especificado, armazena os dados em um buffer alocado pela estrutura e cria um objeto de memória de estrutura para representar o buffer.

Sintaxe

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

Parâmetros

[_In_] Configuration

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

[_In_] ValueName

Um ponteiro para uma estrutura de UNICODE_STRING que contém um nome de valor.

[_In_] PoolType

Um valor POOL_TYPEdigitado que especifica o tipo de memória a ser alocada para o buffer de dados.

[_In_opt_] MemoryAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES que contém atributos de objeto para o novo objeto de memória. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Memory

Um ponteiro para um local que recebe um identificador para o novo objeto de memória. A estrutura aloca esse buffer de memória e o libera automaticamente quando o objeto NETCONFIGURATION é fechado.

Valor de retorno

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.

Observações

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

A memória alocada por essa função é liberada automaticamente pela estrutura quando o objeto NETCONFIGURATION é fechado.

Requisitos

Requisito	Valor
da 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)
IRQL	PASSIVE_LEVEL

Partilhar via