Share via

ParserTemporaryLockFrame

  • Article

The ParserTemporaryLockFrame function locks a frame when it enters a parser and unlocks the frame when the function exits the parser.

LPBYTE WINAPIParserTemporaryLockFrame(HFRAMEhFrame);

Parameters

  • hFrame
    [in] Handle to the frame that the parser points to.

Return Values

If the function is successful, the return value is a pointer to the first byte of data in the frame.

If the function is unsuccessful, the return value is NULL.

Remarks

Parsers should not call the LockFrame function. If a parser takes a lock and then generates a fault or returns without unlocking the frame, the parser leaves the system in a state where it cannot change protocols or cut or copy frames. Parsers should use the ParserTemporaryLockFrame function, which grants a lock only during the context of the function entry into the parser. On exit from the parser, the lock for that frame is released. As a result, the pointer will be valid only after the parser returns from the call to the AttachProperties or RecognizeFrame function.

Requirements

Client Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Header

Declared in Netmon.h.
Library

Link to Nmapi.lib.
DLL Requires Nmapi.dll.