Compartilhar via

Função NetConfigurationAssignUlong (netconfiguration.h)

  • Artigo

A função NetConfigurationAssignUlong grava um valor de palavra longa sem sinal fornecido pelo chamador em um nome de valor especificado no Registro.

Sintaxe

NTSTATUS NetConfigurationAssignUlong(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] ULONG            Value
);

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_] Value

Um valor ULONG que será atribuído ao nome do valor especificado por ValueName .

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, NetConfigurationAssignUlong substituirá seu valor atual pelo valor fornecido pelo chamador. Caso contrário, NetConfigurationAssignUlong 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