Compartilhar via


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 pode 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
Versão mínima do UMDF 2.33
Cabeçalho netconfiguration.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL