NetConfigurationQueryMultiString, fonction (netconfiguration.h)

Article
05/23/2024

Récupère l’entrée de Registre multistring 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érez 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 retournée

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 à l’objet de collection. Le pilote client peut modifier cela en définissant le membre ParentObject de la structure WDF_OBJECT_ATTRIBUTES .

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.21
Version UMDF minimale	2,33
En-tête	netconfiguration.h (inclure netadaptercx.h)
Bibliothèque	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Partager via