ParserTemporaryLockFrame fonction)

La fonction ParserTemporaryLockFrame verrouille un frame lorsqu’il entre dans un analyseur et déverrouille le frame lorsque la fonction quitte l’analyseur.

Syntaxe

LPBYTE WINAPI ParserTemporaryLockFrame(
  _In_ HFRAME hFrame
);

Paramètres

hFrame [ dans]

Handle vers le frame vers lequel pointe l’analyseur.

Valeur de retour

Si la fonction réussit, la valeur de retour est un pointeur vers le premier octet de données dans le frame.

Si la fonction échoue, la valeur de retour est null.

Notes

Les analyseurs ne doivent pas appeler la fonction LockFrame . Si un analyseur prend un verrou, puis génère une erreur ou retourne sans déverrouiller le frame, l’analyseur laisse le système dans un État où il ne peut pas modifier les protocoles ni couper ou copier les frames. Les analyseurs doivent utiliser la fonction ParserTemporaryLockFrame , qui accorde un verrou uniquement pendant le contexte de l’entrée de la fonction dans l’analyseur. À la sortie de l’analyseur, le verrou de ce frame est libéré. Par conséquent, le pointeur est valide uniquement après le retour de l’analyseur à partir de l’appel à la fonction AttachProperties ou RecognizeFrame .

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