Fonction NetConfigurationAssignMultiString (netconfiguration.h)

  • Article

La fonction NetConfigurationAssignMultiString affecte un ensemble de chaînes à un nom de valeur spécifié dans le Registre. Les chaînes sont contenues dans une collection spécifiée d’objets de chaîne d’infrastructure.

Syntaxe

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

Paramètres

[_In_] Configuration

Handle d’un objet NETCONFIGURATION qui représente une clé de Registre ouverte.

[_In_] ValueName

Pointeur vers une structure UNICODE_STRING qui contient un nom de valeur.

[_In_] Collection

Handle d’un objet de collection d’infrastructure qui représente une collection d’objets de chaîne d’infrastructure.

Valeur retournée

Cette fonction retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction peut retourner un code d’erreur NTSTATUS approprié.

Remarques

Le pilote client obtient un handle pour un objet NETCONFIGURATION en appelant NetAdapterOpenConfiguration ou NetConfigurationOpenSubConfiguration.

Si une entrée du même nom que ValueName existe déjà sous la clé de Registre ouverte, NetConfigurationAssignMultiString remplace sa valeur actuelle par la valeur fournie par l’appelant. Sinon, NetConfigurationAssignMultiString ajoute une nouvelle entrée de valeur avec le nom donné et la valeur fournie au Registre.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.21
En-tête netconfiguration.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL