NetConfigurationQueryBinary, fonction (netconfiguration.h)

Récupère les données actuellement affectées à une valeur de Registre spécifiée, stocke les données dans une mémoire tampon allouée à l’infrastructure et crée un objet mémoire de framework pour représenter la mémoire tampon.

Syntaxe

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

Paramètres

[_In_] Configuration

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

[_In_] PoolType

Valeur POOL_TYPE-typée qui spécifie le type de mémoire à allouer pour la mémoire tampon de données.

[_In_opt_] MemoryAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES qui contient des attributs d’objet pour le nouvel objet mémoire. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Memory

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet mémoire. L’infrastructure alloue cette mémoire tampon et la libère automatiquement lorsque l’objet NETCONFIGURATION est fermé.

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.

La mémoire allouée par cette fonction est automatiquement libérée par l’infrastructure lorsque l’objet NETCONFIGURATION est fermé.

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