Função NetConfigurationAssignUnicodeString (netconfiguration.h)

A função NetConfigurationAssignUnicodeString atribui uma cadeia de caracteres Unicode especificada a um nome de valor especificado no registro.

Sintaxe

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING 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 ponteiro para uma estrutura UNICODE_STRING que contém a cadeia de caracteres a ser atribuída 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 já existir uma entrada com o mesmo nome que ValueName na chave do Registro aberta, NetConfigurationAssignUnicodeString substituirá seu valor atual pelo valor fornecido pelo chamador. Caso contrário, NetConfigurationAssignUnicodeString 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
Cabeçalho	netconfiguration.h (inclua netadaptercx.h)
IRQL	PASSIVE_LEVEL