NetConfigurationQueryString, fonction (netconfiguration.h)

Article
02/07/2025

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é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 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 vers un objet de chaîne d’infrastructure. NetAdapterCx affecte les données de chaîne de la valeur de Registre à cet objet.

Valeur de retour

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é 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)
IRQL	PASSIVE_LEVEL

Partager via