NetConfigurationQueryMultiString, fonction (netconfiguration.h)

Article
02/07/2025

Récupère l’entrée de Registre à valeurs MultipleString associée à un nom de valeur dans l’objet de configuration spécifié.

Syntaxe

NTSTATUS NetConfigurationQueryMultiString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringsAttributes,
  [_Inout_]  WDFCOLLECTION         Collection
);

Paramètres

[_In_] Configuration

Gérer 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 dans la clé logicielle de l’appareil.

[_In_opt_] StringsAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES qui contient des attributs fournis par le pilote pour les nouveaux objets WDFSTRING. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[_Inout_] Collection

Handle d’un objet de collection fourni par le pilote. Si la fonction réussit, contient un objet WDFSTRING pour chaque chaîne affectée à ValueName.

Valeur de retour

La fonction retourne STATUS_SUCCESS si l’opération réussit. Si la valeur de Registre est NULL, NetConfigurationQueryMultiString retourne STATUS_OBJECT_NAME_NOT_FOUND.

Remarques

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

Par défaut, les chaînes sont parentées de l’objet de collection. Le pilote client peut le modifier en définissant l'ParentObject membre de la structure WDF_OBJECT_ATTRIBUTES.

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)
bibliothèque	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Partager via