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