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