Fonction TcQueryInterface (traffic.h)

La fonction TcQueryInterface interroge le contrôle du trafic pour les paramètres par interface associés. Un paramètre de contrôle du trafic est interrogé en fournissant son identificateur global unique (GUID). La définition du paramètre NotifyChange sur TRUE active la notification d’événement sur le GUID spécifié, après quoi les événements de notification sont envoyés à un client chaque fois que le paramètre interrogé change. Les GUID pour lesquels les clients peuvent demander une notification se trouvent dans l’entrée GUID ; la colonne intitulée « Notification » indique quels GUID sont disponibles pour la notification.

Syntaxe

ULONG TcQueryInterface(
  [in]      HANDLE  IfcHandle,
  [in]      LPGUID  pGuidParam,
  [in]      BOOLEAN NotifyChange,
  [in, out] PULONG  pBufferSize,
  [out]     PVOID   Buffer
);

Paramètres

[in] IfcHandle

Handle associé à l’interface à interroger. Ce handle est obtenu par un appel précédent à la fonction TcOpenInterface .

[in] pGuidParam

Pointeur vers l’identificateur global unique (GUID) qui correspond au paramètre de contrôle du trafic interrogé.

[in] NotifyChange

Utilisé pour demander des notifications du contrôle de trafic pour le paramètre interrogé. Si la valeur est TRUE, le contrôle du trafic avertit le client, par le biais de la fonction ClNotifyHandler , en cas de modification du paramètre correspondant au GUID fourni dans pGuidParam. Les notifications sont désactivées par défaut.

[in, out] pBufferSize

Indique la taille de la mémoire tampon, en octets. Pour l’entrée, cette valeur correspond à la taille de la mémoire tampon allouée par l’appelant. Pour la sortie, cette valeur correspond à la taille réelle de la mémoire tampon, en octets, utilisée par le contrôle du trafic.

[out] Buffer

Pointeur vers une mémoire tampon allouée par le client dans laquelle les données retournées seront écrites.

Valeur retournée

Notez que, en ce qui concerne un état de notification demandé, seule une valeur de retour de NO_ERROR entraîne l’application de l’état de notification demandé. Si une valeur de retour autre que NO_ERROR est retournée à partir d’un appel à la fonction TcQueryInterface , la modification demandée de l’état de notification n’est pas acceptée.

Code de retour	Description
NO_ERROR	La fonction s’est exécutée sans erreurs.
ERROR_INVALID_HANDLE	Handle d’interface non valide.
ERROR_INVALID_PARAMETER	Paramètre non valide ou NULL .
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon est trop petite pour stocker les résultats.
ERROR_NOT_SUPPORTED	L’interrogation du GUID fourni n’est pas prise en charge sur l’interface fournie.
ERROR_WMI_GUID_NOT_FOUND	L’appareil ne s’est pas inscrit à ce GUID.
ERROR_WMI_INSTANCE_NOT_FOUND	Le nom instance est introuvable, probablement parce que l’interface est en cours de fermeture.

Remarques

Note L’utilisation de la fonction TcQueryInterface nécessite des privilèges d’administration.

 

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	traffic.h
Bibliothèque	Traffic.lib
DLL	Traffic.dll

Voir aussi

ClNotifyHandler

TcEnumerateInterfaces

TcRegisterClient