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 |
|
| Bibliothèque |
|
| DLL |
|