NetConfigurationQueryMultiString, fonction (netconfiguration.h)

  • Article

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
En-tête netconfiguration.h (inclure netadaptercx.h)
Bibliothèque NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL