FindNextFrame fonction)

La fonction FindNextFrame recherche le frame suivant dans le contexte de capture actuel qui correspond au filtre.

Syntaxe

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

Paramètres

hCurrentFrame

Handle du frame.

ProtocolName

Nom de protocole, tel que TCP.

DestinationAddress

Adresse de destination.

SourceAddress

Adresse source.

ProtocolOffset

Pointeur vers un mot qui recevra le décalage de protocole.

OriginalFrameNumber

Point de départ de la recherche. Par défaut, cette fonction recherche les frames Forward 1 000 à partir du point de départ OriginalFrameNumber . Pour modifier la distance de recherche, ajoutez la ligne suivante au fichier Nmapi.ini, situé dans le \ répertoire Moniteur réseau.

MAXLOOKBACK =

HighestFrame

Numéro de trame le plus élevé 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 suivant.

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

Notes

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

Le pointeur ProtocolOffset est retourné à l’analyseur appelant, qui ajoute le mot au pointeur retourné en verrouillant le 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 ce frame n’est pas celui qui est recherché, l’analyseur peut remettre le HFRAME à la fonction FindNextFrame pour accéder au frame suivant. Les adresses source et de destination ne sont pas requises et peuvent être passées comme null.

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