Função NetConfigurationAssignBinary (netconfiguration.h)

Artigo
02/07/2025

A função NetConfigurationAssignBinary grava dados binários fornecidos pelo chamador em um nome de valor especificado no registro.

Sintaxe

NTSTATUS NetConfigurationAssignBinary(
  [_In_]                             NETCONFIGURATION Configuration,
  [_In_]                             PCUNICODE_STRING ValueName,
  [__In_reads_bytes_(BufferLength)_] void             *Buffer,
  [_In_]                             ULONG            BufferLength
);

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_reads_bytes_(BufferLength)_] Buffer

Um ponteiro para um buffer que contém dados fornecidos pelo driver.

[_In_] BufferLength

O comprimento, em bytes, do buffer ao qual buffer pontos.

Valor de retorno

Essa 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.

Se uma entrada com o mesmo nome que ValueName já existir na chave do Registro aberta, NetConfigurationAssignBinary substituirá seu valor atual pelo valor fornecido pelo chamador. Caso contrário, NetConfigurationAssignBinary adiciona uma nova entrada de valor com o nome fornecido e o valor fornecido ao registro.

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

Compartilhar via