GetProtocolStartOffset-Funktion

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 0 (null) durchsucht 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 an einen Frame übergeben wird, gibt diese Funktion den Offset an ein angegebenes Protokoll im Frame zurück. Um beispielsweise zu bestimmen, ob der Frame ein DNS-Frame ist, benötigt der DNS-Parser die Portadresse des TCP-Protokolls. Der DNS-Parser würde diese Funktion mit TCP als ProtocolName-Wert aufrufen. 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 vor liegt, ist der Rückgabewert 0 (null).

Diese Funktion sucht den Anfang eines Protokolls in einem Frame.

Requirements (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