Partager via


Fonction de rappel FormatProperties

La fonction d’exportation FormatProperties met en forme les données affichées dans le volet d’informations de l’interface utilisateur du Moniteur réseau. Si vous souhaitez afficher des données dans le volet d’informations, vous devez implémenter la fonction d’exportation FormatProperties dans toutes les DLL de l’analyseur.

Syntaxe

DWORD FormatProperties(
  _In_ HFRAME         hFrame,
  _In_ LPBYTE         lpFrame,
  _In_ LPBYTE         lpProtocol,
  _In_ DWORD          nPropertyInsts,
  _In_ LPPROPERTYINST lpPropInst
);

Paramètres

hFrame [in]

Handle vers le cadre en cours d’analyse.

lpFrame [in]

Pointeur vers le premier octet d’un frame.

lpProtocol [in]

Pointeur vers le début des données de protocole dans un frame.

nPropertyInsts [in]

Nombre de structures PROPERTYINST fournies par lpPropInst.

lpPropInst [in]

Pointeur vers un tableau de structures PROPERTYINST .

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE.

Notes

Le Moniteur réseau appelle la fonction FormatProperties pour afficher les données dans le volet d’informations de l’interface utilisateur du Moniteur réseau. En règle générale, FormatProperties est appelé pour mettre en forme la ligne récapitulative d’un protocole, puis pour mettre en forme toutes les instances de propriété du protocole dans un cadre. Toutefois, network Monitor ne garantit pas le nombre de fois où il appelle FormatProperties pour un analyseur spécifique.

Pendant l’implémentation de la fonction FormatProperties , l’analyseur appelle indirectement la fonction FormatPropertyInstance pour utiliser le formateur générique fourni par network Monitor, ou il peut appeler une procédure de formateur personnalisée définie par l’analyseur. L’un des formateurs doit être appelé pour chaque structure PROPERTYINST passée à la DLL de l’analyseur dans le paramètre lpPropInst .

Pour plus d’informations sur Consultez
Quels sont les analyseurs et comment ils fonctionnent avec le Moniteur réseau. Analyseurs
Points d’entrée inclus dans la DLL de l’analyseur. Architecture dll de l’analyseur
L’implémentation de FormatProperties inclut un exemple. Implémentation de FormatProperties
Comment le formateur générique met en forme différents types de données. Sortie du formateur générique

Spécifications

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]
En-tête
Netmon.h

Voir aussi

FormatPropertyInstance

PROPERTYINFO

PROPERTYINST