FindNextFrame-Funktion
Die FindNextFrame-Funktion sucht den nächsten Frame im aktuellen Aufnahmekontext, der dem Filter entspricht.
Syntax
HFRAME WINAPI FindNextFrame(
HFRAME hCurrentFrame,
LPSTR ProtocolName,
LPADDRESS DestinationAddress,
LPADDRESS SourceAddress,
LPWORD ProtocolOffset,
DWORD OriginalFrameNumber,
DWORD HighestFrame
);
Parameter
-
hCurrentFrame
-
Ein Handle zum Rahmen.
-
ProtocolName
-
Der Protokollname, z. B. TCP.
-
DestinationAddress
-
Die Zieladresse.
-
SourceAddress
-
Die Quelladresse.
-
ProtocolOffset
-
Ein Zeiger auf ein WORD , das den Protokolloffset empfängt.
-
OriginalFrameNumber
-
Der Ausgangspunkt der Suche. Standardmäßig durchsucht diese Funktion 1.000 Frames vom Ausgangspunkt OriginalFrameNumber nach vorne. Um den Vorwärtssuchabstand zu ändern, fügen Sie diese Zeile der Nmapi.ini-Datei im Verzeichnis \Network Monitor hinzu.
MAXLOOKBACK=<new lookforward distance>
-
HöchsterFrame
-
Die höchste Framezahl in der Durchsuchung.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den nächsten Frame.
Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert NULL.
Bemerkungen
Der Erfassungsfilter wird hauptsächlich durch den Parameter ProtocolName definiert, der die einzige erforderliche Filtereingabe ist. Sie können DestinationAddress - und SourceAddress-Daten hinzufügen, um die Erfassungsgeschwindigkeit zu erhöhen.
Der ProtocolOffset-Zeiger wird an den aufrufenden Parser zurückgegeben , der word dem Zeiger hinzufügt, der zurückgegeben wird, indem der Frame (mit ParserTemporaryLockFrame) gesperrt wird, um das LPBYTE des gesuchten Protokolls abzurufen. Bei der Rückgabe wird der HFRAME, der den Filter übergeben hat, an den Parser übergeben. Wenn der Parser feststellt, dass dieser Frame nicht der gesuchte ist, kann der Parser den HFRAME zurück an die FindNextFrame-Funktion übergeben, um den nächsten Frame zu erhalten. Die Quell- und Zieladressen sind nicht erforderlich und können als NULL übergeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|