GetProtocolStartOffset, fonction

La fonction GetProtocolStartOffset retourne le décalage d’un protocole spécifié dans le cadre.

Syntaxe

DWORD WINAPI GetProtocolStartOffset(
   HFRAME hFrame,
   LPSTR  ProtocolName
);

Paramètres

hFrame

Poignée du cadre.

ProtocolName

Nom du protocole, par exemple TCP.

Valeur retournée

Si la fonction réussit, la valeur de retour est un décalage DWORD par rapport au début du protocole recherché pour une valeur de retour de zéro indiquant que le protocole est le premier protocole de l’image.

Si la fonction échoue, le protocole n’est pas dans le cadre, la valeur de retour est -1.

Notes

Lorsqu’elle donne le handle à une image, cette fonction retourne le décalage à un protocole spécifié dans l’image. Par exemple, pour déterminer si la trame est une trame DNS, l’analyseur DNS nécessite l’adresse de port du protocole TCP. L’analyseur DNS appelle cette fonction avec TCP comme valeur ProtocolName . Si l’image est reconnue par le protocole TCP, le décalage WORD entre le début de l’image et le début de la trame TCP est retourné. S’il n’existe aucun protocole TCP, la valeur de retour est zéro.

Cette fonction trouve le début d’un protocole dans un frame.

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	Netmon.h
Bibliothèque	Nmapi.lib
DLL	Nmapi.dll