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