FormatPropertyInstance 函式
FormatPropertyInstance函式會使用網路監視器所提供的泛型格式器，格式化屬性實例資料。
語法
DWORD WINAPIV FormatPropertyInstance(
_Inout_ LPPROPERTYINST lpPropertyInst
);
參數
-
lpPropertyInst [in， out]
-
包含實例資料的 PROPERTYINST 結構的指標。
在輸入時，泛型格式器會從其中一個 PROPERTYINST 等位成員取得實例資料，並將該資料轉換成預先定義的格式化字串。
在輸出時，泛型格式器會將PROPERTYINST結構的szPropertyText成員設定為格式化字串的指標。
傳回值
如果函式成功，傳回值會NMERR_SUCCESS。
如果函式失敗，則傳回值是 NMerr.h 的錯誤碼。
備註
剖析器 DLL 會在需要泛型格式器時間接呼叫 FormatPropertyInstance 函式，以格式化資料以在網路監視器 UI 的詳細資料窗格中顯示。 當您定義 屬性時，若要呼叫FormatPropertyInstance，請在PROPERTYINFO結構的InstanceData成員中指定它。
注意
剖析器無法辨識何時必須格式化屬性實例時所呼叫的函式。 此函式可以是 FormatPropertyInstance 或剖析器所定義的自訂格式函式。 剖析器會呼叫屬性之 PROPERTYINFO結構的InstanceData成員所指定的任何格式函式。
如需如何實作 formatproperties的詳細資訊和範例，請參閱 實作 FormatProperties。 如需泛型格式器如何格式化不同類型的資料的詳細資訊，請參閱 泛型格式器輸出。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|