Função NetConfigurationAssignUlong (netconfiguration.h)

Artigo
02/07/2025

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

[_In_] ValueName

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

[_In_] Value

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

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