Função NetConfigurationAssignMultiString (netconfiguration.h)

Artigo
02/07/2025

A função NetConfigurationAssignMultiString atribui um conjunto de cadeias de caracteres a um nome de valor especificado no registro. As cadeias de caracteres estão contidas em uma coleção especificada de objetos de cadeia de caracteres da estrutura.

Sintaxe

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

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

Um identificador para um objeto de coleção de estruturas que representa uma coleção de objetos de cadeia de caracteres da estrutura.

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 já existir uma entrada com o mesmo nome que ValueName na chave aberta do Registro, NetConfigurationAssignMultiString substituirá seu valor atual pelo valor fornecido pelo chamador. Caso contrário, NetConfigurationAssignMultiString 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