Fonction de rappel AttachProperties
La fonction d’exportation AttachProperties mappe les propriétés à un emplacement dans une partie de 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 [in]
-
Handle du frame en cours d’analyse.
-
lpFrame [in]
-
Pointeur vers le premier octet d’un cadre.
-
lpProtocol [in]
-
Pointeur vers le début des données reconnues.
-
MacType [in]
-
Valeur MAC du premier protocole d’un frame. Le MacType peut être l’un des éléments suivants :
Valeur Signification - MAC_TYPE_ETHERNET
802.3 - MAC_TYPE_TOKENRING
802.5 - MAC_TYPE_FDDI
ANSI X3T9.5 -
BytesLeft [in]
-
Nombre restant d’octets dans une image commençant au début des données reconnues.
-
hPreviousProtocol [in]
-
Handle du protocole précédent.
-
nPreviousProtocolOffset [in]
-
Décalage du protocole précédent commençant au début de l’image.
-
lpInstData [in]
-
Pointeur vers les données instance que le protocole précédent fournit. Les données d’instance ne peuvent pas être plus longues qu’une DWORD_PTR.
Valeur retournée
Si la fonction réussit, la valeur de retour est un pointeur vers le premier octet après les données reconnues dans une image ou NULL si les données reconnues sont le dernier élément de 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 vers la DLL de l’analyseur.
Notes
Le moniteur réseau appelle la fonction AttachProperties pour chaque analyseur qui reconnaît un morceau de données dans un frame. Notez que l’analyseur détermine les propriétés qui existent dans les données reconnues et 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 Network Monitor dispose d’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 qui sont transmises d’un analyseur à un autre. Les données d’instance peuvent être des données inférieures ou égales à une longueur DWORD_PTR, ou un pointeur vers des données, telles que les données de trame brutes, qui n’ont pas besoin d’être allouées par ou libérées par l’analyseur. Dans le paramètre lpInstData des fonctions AttachProperties et RecognizeFrame, Network Monitor fournit un pointeur vers les données instance du protocole précédent. Vous pouvez définir les données instance pour votre analyseur lors de l’implémentation de RecognizeFrame.
| Pour plus d’informations sur | Consultez |
|---|---|
| Quels sont les analyseurs et comment ils fonctionnent avec le Moniteur réseau. | Analyseurs |
| Quels points d’entrée sont inclus dans la DLL de l’analyseur. | Architecture 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 d’AttachProperties inclut un exemple. | Implémentation d’AttachProperties |
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 |
|