Fungsi AttachPropertyInstance

Fungsi AttachPropertyInstance memetakan properti yang ada ke lokasi tertentu dalam data yang dikenali.

Sintaks

BOOL WINAPI AttachPropertyInstance(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     HelpID,
  _In_ DWORD     IndentLevel,
  _In_ DWORD     IFlags
);

Parameter

hFrame [in]

Tangani ke bingkai yang sedang diurai. Gunakan handel yang diteruskan ke DLL pengurai dalam parameter hFrame fungsi AttachProperties .

hProperty [in]

Tangani ke struktur PROPERTYINFO yang menentukan properti . Saat Anda menerapkan fungsi ekspor Daftar, Anda menentukan struktur PROPERTYINFO yang menentukan properti .

Panjang [in]

Panjang data untuk instans properti ini.

lpData [in]

Arahkan ke lokasi dalam data yang dikenali tempat nilai properti berada. Gunakan pointer yang diteruskan ke DLL pengurai dalam parameter lpProtocol dari fungsi AttachProperties .

HelpID [in]

Pengidentifikasi (dari 0 hingga 2047) yang digunakan untuk mengatur Bantuan sensitif konteks untuk properti.

Nomor pengidentifikasi relatif terhadap file Bantuan yang terkait dengan database properti protokol.

IndentLevel [in]

Tingkat indentasi (dari 0 hingga 15) digunakan untuk menampilkan properti secara hierarkis.

Monitor Jaringan menggunakan tingkat 0 hingga 14 untuk inden properti. Tingkat 15 adalah nilai khusus yang memungkinkan pengurai melampirkan properti tersembunyi yang tidak terlihat.

IFlags [in]

Nilai bidang BIT yang menunjukkan urutan BIT dalam properti . Pengurai sebelumnya yang mengatur fError ke 0 atau 1, sekarang harus mengatur fError ke IFLAG_ERROR. Atur parameter ini ke salah satu nilai berikut.

Nilai	Makna
IFLAG_ERROR	Data dalam bingkai memiliki kesalahan.
IFLAG_SWAPPED	Pada waktu lampiran, byte WORD adalah format non-Intel.
IFLAG_UNICODE	Pada waktu lampirkan, STRING adalah Unicode.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi tidak berhasil, nilai yang dikembalikan adalah FALSE.

Keterangan

Fungsi AttachPropertyInstance dipanggil selama implementasi fungsi ekspor AttachProperties . Saat properti dilampirkan ke data, Monitor Jaringan membuat struktur PROPERTYINST yang menentukan instans properti terlampir.

Selama implementasi AttachProperties, panggil AttachPropertyInstance untuk menggunakan data seperti yang ada dalam tangkapan. Anda juga dapat memanggil fungsi AttachPropertyInstanceEx untuk mengubah data properti. Namun, disarankan agar Anda menggunakan data seperti yang ada dalam pengambilan.

Untuk Informasi tentang	Lihat
Apa itu pengurai, dan cara kerjanya dengan Monitor Jaringan.	Parser
Cara memanggil AttachPropertyInstance.	Menerapkan AttachProperties

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

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST