NetConfigurationQueryString, fonction (netconfiguration.h)

Article
05/23/2024

Récupère la valeur de chaîne spécifiée à partir de l’objet de configuration de l’adaptateur et affecte la chaîne à un objet de chaîne d’infrastructure spécifié.

Syntaxe

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);

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 pour la valeur de chaîne.

[_In_opt_] StringAttributes

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

[_Out_] WdfString

Handle d’un objet de chaîne de framework. NetAdapterCx affecte les données de chaîne de la valeur de Registre à cet objet.

Valeur retournée

La 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.

Par défaut, l’objet de chaîne de framework est parenté à 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)
IRQL	PASSIVE_LEVEL

Partager via