Fungsi FormatPropertyInstance

Fungsi FormatPropertyInstance memformat data instans properti menggunakan formatter generik yang disediakan Network Monitor.

Sintaks

DWORD WINAPIV FormatPropertyInstance(
  _Inout_ LPPROPERTYINST lpPropertyInst
);

Parameter

lpPropertyInst [masuk, keluar]

Penunjuk ke struktur PROPERTYINST yang berisi data instans.

Pada input, pemformat generik mengambil data instans dari salah satu anggota serikat PROPERTYINST dan mengonversi data tersebut menjadi string berformat yang telah ditentukan sebelumnya.

Pada output, formatter generik mengatur anggota szPropertyText dari struktur PROPERTYINST ke penunjuk ke string yang diformat.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NMERR_SUCCESS.

Jika fungsi tidak berhasil, nilai yang dikembalikan adalah kode kesalahan dari NMerr.h.

Keterangan

DLL pengurai secara tidak langsung memanggil fungsi FormatPropertyInstance saat pemformat generik diperlukan untuk memformat data untuk ditampilkan di panel detail UI Monitor Jaringan. Untuk memanggil FormatPropertyInstance , tentukan di anggota InstanceData struktur PROPERTYINFO saat Anda menentukan properti .

Catatan

Pengurai tidak mengenali fungsi mana yang dipanggil ketika harus memformat instans properti. Fungsinya dapat berupa FormatPropertyInstance atau fungsi format kustom yang ditentukan oleh pengurai. Pengurai memanggil fungsi format apa pun yang ditentukan oleh anggota InstanceData dari struktur PROPERTYINFO untuk properti .

Untuk informasi selengkapnya dan contoh cara menerapkan formatproperti, lihat Menerapkan FormatProperties. Untuk informasi selengkapnya tentang bagaimana format pemformat generik memformat berbagai jenis data, lihat Output Formatter Generik.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Netmon.h
Pustaka	Nmapi.lib
DLL	Nmapi.dll

Lihat juga

PROPERTYINFO

PROPERTYINST