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 par l’infrastructure et crée un objet mémoire du 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 d’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 de type POOL_TYPE qui spécifie le type de mémoire à allouer à 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 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.

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

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