AttachProperties fonction de rappel

La fonction d’exportation AttachProperties mappe les propriétés à un emplacement dans une partie des données reconnues. AttachProperties doit être implémenté pour chaque analyseur pris en charge par la dll de l’analyseur.

Syntaxe

DWORD AttachProperties(
  _In_ HFRAME    hFrame,
  _In_ LPBYTE    lpFrame,
  _In_ LPBYTE    lpProtocol,
  _In_ DWORD     MacType,
  _In_ DWORD     BytesLeft,
  _In_ HPROTOCOL hPreviousProtocol,
  _In_ DWORD     nPreviousProtocolOffset,
  _In_ DWORD     lpInstData
);

Paramètres

hFrame [ dans]

Handle du frame en cours d’analyse.

lpFrame [ dans]

Pointeur vers le premier octet d’un frame.

lpProtocol [ dans]

Pointeur vers le début des données reconnues.

MacType [ dans]

Valeur MAC du premier protocole dans un frame. Le paractype peut être l’un des suivants :

Valeur Signification
MAC _ type _ Ethernet
802.3
_type Mac _ TOKENRING
802.5
_type Mac _ FDDI
ANSI X3T 9.5

BytesLeft [ dans]

Nombre d’octets restants dans un frame à partir du début des données reconnues.

hPreviousProtocol [ dans]

Handle du protocole précédent.

nPreviousProtocolOffset [ dans]

Décalage du protocole précédent à partir du début du frame.

lpInstData [ dans]

Pointeur vers les données d’instance fournies par le protocole précédent. La longueur des données d’instance ne peut pas être supérieure à celle _ d’un PTR DWORD.

Valeur de retour

Si la fonction réussit, la valeur de retour est un pointeur vers le premier octet après les données reconnues dans un frame ou null si les données reconnues sont la dernière partie des données d’un frame.

Si la fonction échoue, la valeur de retour est un pointeur vers les données reconnues. Le paramètre lpProtocol passe le pointeur à la dll de l’analyseur.

Remarques

Moniteur réseau appelle la fonction AttachProperties pour chaque analyseur qui reconnaît un élément de données dans un frame. Notez que l’analyseur détermine les propriétés qui existent dans les données reconnues, ainsi que l’emplacement de chaque propriété.

Pendant l’implémentation de AttachProperties, appelez AttachPropertyInstance pour utiliser les données telles qu’elles existent dans la capture. Vous pouvez également appeler la fonction AttachPropertyInstanceEx pour modifier les données de propriété. Toutefois, il est recommandé d’utiliser les données telles qu’elles existent dans la capture.

Les fonctions AttachPropertyInstanceEx et AttachPropertyInstance sont appelées uniquement pour les propriétés qui existent dans les données reconnues. Notez que Moniteur réseau a une base de données de propriétés pour l’analyseur qui contient une description de toutes les propriétés prises en charge par l’analyseur.

Données d’instance

Les données d’instance sont des informations transmises d’un analyseur à un autre. Les données d’instance peuvent être des données qui sont inférieures ou égales à un _ ptr DWORD en longueur, ou un pointeur vers des données, telles que des données de trame brutes, qui n’a pas besoin d’être alloué ou libéré par l’analyseur. Dans le paramètre lpInstData des fonctions AttachProperties et RecognizeFrame , moniteur réseau fournit un pointeur vers les données d’instance du protocole précédent. Vous pouvez définir les données d’instance de votre analyseur lors de l’implémentation de RecognizeFrame.

Pour plus d’informations sur Consultez
Ce que sont les analyseurs et comment ils fonctionnent avec Moniteur réseau. Analyseurs
Les points d’entrée inclus dans la DLL de l’analyseur. Architecture des DLL de l’analyseur
Comment reconnaître des données. Implémentation de RecognizeFrame
Comment créer une base de données de propriétés. Implémentation du Registre
L’implémentation de AttachProperties comprend un exemple. Implémentation de AttachProperties

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

Voir aussi

AttachPropertyInstance

AttachPropertyInstanceEx

RecognizeFrame