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 [僅限桌面應用程式] |
| 標頭 |
|