Função NetConfigurationAssignBinary (netconfiguration.h)

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 do Registro aberta.

[_In_] ValueName

Um ponteiro para uma estrutura 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 para o qual o Buffer aponta.

Retornar valor

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.

Comentários

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