FormatProperties 回调函数

FormatProperties 导出函数格式化网络监视器 UI 的详细信息窗格中显示的数据。 如果要在详细信息窗格中显示数据，则必须在所有分析程序 DLL 中实现 FormatProperties 导出函数。

语法

DWORD FormatProperties(
  _In_ HFRAME         hFrame,
  _In_ LPBYTE         lpFrame,
  _In_ LPBYTE         lpProtocol,
  _In_ DWORD          nPropertyInsts,
  _In_ LPPROPERTYINST lpPropInst
);

参数

hFrame [in]

要分析的帧的句柄。

lpFrame [in]

指向帧的第一个字节的指针。

lpProtocol [in]

指向帧中协议数据开头的指针。

nPropertyInsts [in]

lpPropInst 提供的 PROPERTYINST 结构数。

lpPropInst [in]

指向 PROPERTYINST 结构的数组的指针。

返回值

如果函数成功，则返回值为 TRUE。

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

备注

网络监视器调用 FormatProperties 函数，以在网络监视器 UI 的详细信息窗格中显示数据。 通常，调用 FormatProperties 以设置协议的摘要行的格式，然后设置框架中协议的所有属性实例的格式。 但是，网络监视器不保证为特定分析程序调用 FormatProperties 的次数。

在 FormatProperties 函数的实现期间，分析程序间接调用 FormatPropertyInstance 函数以使用网络监视器提供的泛型格式化程序，或者它可以调用分析程序定义的自定义格式化程序过程。 必须为传递到 lpPropInst 参数中分析程序 DLL 的每个 PROPERTYINST 结构调用一个格式化程序。

有关的信息	请参阅
什么是分析程序，以及它们如何与网络监视器配合使用。	分析器
分析程序 DLL 中包含哪些入口点。	分析器 DLL 体系结构
如何实现 FormatProperties 包括一个示例。	实现 FormatProperties
泛型格式化程序如何设置不同类型的数据的格式。	泛型格式化程序输出

要求

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

另请参阅

FormatPropertyInstance

PROPERTYINFO

PROPERTYINST