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 |
|
| Bibliothek |
|
| DLL |
|