ParserTemporaryLockFrame 函数

ParserTemporaryLockFrame 函数在进入分析程序时锁定帧，并在函数退出分析程序时解锁该帧。

语法

LPBYTE WINAPI ParserTemporaryLockFrame(
  _In_ HFRAME hFrame
);

参数

hFrame [in]

分析程序指向的帧的句柄。

返回值

如果函数成功，则返回值是指向帧中数据的第一个字节的指针。

如果该函数不成功，则返回值为 NULL。

备注

分析程序不应调用 LockFrame 函数。 如果分析程序获取锁，然后生成错误或返回而不解锁帧，则分析程序会使系统处于无法更改协议或剪切或复制帧的状态。 分析程序应使用 ParserTemporaryLockFrame 函数，该函数仅在函数条目进入分析程序的上下文期间授予锁。 退出分析程序时，释放该帧的锁。 因此，只有在分析程序从 AttachProperties 或 RecognizeFrame 函数的调用返回后，指针才有效。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Netmon.h
库	Nmapi.lib
DLL	Nmapi.dll