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 |
|
| Bibliothèque |
|
| DLL |
|