Função NetConfigurationAssignMultiString (netconfiguration.h)

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

[_In_] ValueName

Um ponteiro para uma estrutura 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 de estrutura.

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, 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
Plataforma de Destino	Universal
Versão mínima do KMDF	1.21
Cabeçalho	netconfiguration.h (inclua netadaptercx.h)
IRQL	PASSIVE_LEVEL