NetConfigurationAssignUnicodeString, fonction (netconfiguration.h)

La fonction NetConfigurationAssignUnicodeString affecte une chaîne Unicode spécifiée à un nom de valeur spécifié dans le Registre.

Syntaxe

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING Value
);

Paramètres

[_In_] Configuration

Handle vers 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_] Value

Pointeur vers une structure UNICODE_STRING qui contient la chaîne à affecter au nom de valeur spécifié ValueName.

Valeur de retour

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, NetConfigurationAssignUnicodeStr ing remplace sa valeur actuelle par la valeur fournie par l’appelant. Sinon, NetConfigurationAssignUnicodeString ajoute une nouvelle entrée de valeur avec le nom donné et la valeur fournie au Registre.

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.21
version minimale de UMDF	2.33
d’en-tête	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL