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 [仅限桌面应用] |
| 标头 |
|