FindPreviousFrame fonction)

La fonction FindPreviousFrame recherche le frame précédent dans le contexte de capture actuel qui correspond au filtre.

Syntaxe

HFRAME WINAPI FindPreviousFrame(
   HFRAME    hCurrentFrame,
   LPSTR     ProtocolName,
   LPADDRESS DestinationAddress,
   LPADDRESS SourceAddress,
   LPWORD    ProtocolOffset,
   DWORD     OriginalFrameNumber,
   DWORD     LowestFrame
);

Paramètres

hCurrentFrame

Handle vers le frame.

ProtocolName

Nom de protocole, tel que TCP.

DestinationAddress

Adresse de destination du frame recherché.

SourceAddress

Adresse source du frame recherché.

ProtocolOffset

Pointeur vers un mot qui reçoit le décalage de protocole.

OriginalFrameNumber

Point de départ de la recherche. Par défaut, cette fonction effectue une recherche vers l’arrière 1 000 frames à partir du point de départ OriginalFrameNumber . Vous pouvez modifier la distance de recherche en ajoutant cette ligne au fichier Nmapi.ini, qui se trouve dans le \ répertoire Moniteur réseau.

MAXLOOKBACK =

LowestFrame

Numéro de trame le plus bas dans la capture dans laquelle la recherche est effectuée.

Valeur de retour

Si la fonction réussit, la valeur de retour est un handle vers le frame précédent.

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

Notes

Le filtre de capture est défini principalement par ProtocolName, qui est la seule entrée de filtre requise ; vous pouvez ajouter des informations DestinationAddress et sourceAddress pour augmenter la vitesse de capture.

ProtocolOffset est retourné à l’analyseur appelant, ce qui ajoute ce DWORD au pointeur retourné par le verrouillage du frame (avec PARSERTEMPORARYLOCKFRAME) pour obtenir le LPBYTE du protocole recherché. Au retour, le HFRAME qui a réussi le filtre est donné à l’analyseur. Si l’analyseur constate que le frame n’est pas celui qui est recherché, l’analyseur peut remettre ce HFRAME à la fonction FindPreviousFrame pour récupérer le frame suivant. Les adresses source et de destination, qui ne sont pas nécessaires, peuvent être transmises en tant que valeurs NULL. En cas d’utilisation, ces adresses peuvent être de type adresse _ _ IP, et ainsi de suite, pas seulement des types Mac.

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
Bibliothèque
Nmapi. lib
DLL
Nmapi.dll