GetProtocolStartOffset-Funktion

Artikel
06/13/2023

Die GetProtocolStartOffset-Funktion gibt den Offset eines angegebenen Protokolls im Frame zurück.

Syntax

DWORD WINAPI GetProtocolStartOffset(
   HFRAME hFrame,
   LPSTR  ProtocolName
);

Parameter

hFrame: Ein Handle für den Frame.
ProtocolName: Der Protokollname, z. B. TCP.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein DWORD-Offset zum Anfang des Protokolls, das nach einem Rückgabewert von null gesucht wird, gibt an, dass das Protokoll das erste Protokoll im Frame ist.

Wenn die Funktion nicht erfolgreich ist, befindet sich das Protokoll nicht im Frame, der Rückgabewert ist -1.

Bemerkungen

Wenn das Handle einem Frame zugewiesen wird, gibt diese Funktion den Offset zu einem angegebenen Protokoll im Frame zurück. Um beispielsweise zu ermitteln, ob es sich bei dem Frame um einen DNS-Frame handelt, benötigt der DNS-Parser die Portadresse des TCP-Protokolls. Der DNS-Parser ruft diese Funktion mit TCP als ProtocolName-Wert auf. Wenn der Frame vom TCP-Protokoll erkannt wird, wird der WORD-Offset vom Anfang des Frames bis zum Anfang des TCP-Frames zurückgegeben. Wenn kein TCP-Protokoll vorhanden ist, ist der Rückgabewert 0.

Diese Funktion findet den Anfang eines Protokolls in einem Frame.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Netmon.h
Bibliothek	Nmapi.lib
DLL	Nmapi.dll

Freigeben über