Fungsi AttachPropertyInstanceEx

Fungsi AttachPropertyInstanceEx memetakan properti yang ada ke lokasi tertentu dalam data yang dikenali, dan memodifikasi nilai data properti.

Sintaks

BOOL WINAPI AttachPropertyInstanceEx(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     LengthEx,
  _In_ ULPVOID   lpDataEx,
  _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 .

LengthEx [in]

Panjang panjang data yang diperluas dalam byte.

lpDataEx [in]

Penunjuk ke data yang diperluas, yang biasanya merupakan variabel tumpukan yang berisi data perluasan.

HelpID [in]

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

Nomor HelpID 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 9. 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.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi tidak berhasil, nilai yang dikembalikan adalah FALSE.

Keterangan

Fungsi AttachPropertyInstanceEx dipanggil selama implementasi fungsi ekspor AttachProperties . Saat properti dilampirkan ke data menggunakan AttachPropertyInstanceEx, Network Monitor membuat struktur PROPERTYINST yang menentukan instans properti terlampir dan struktur PROPERTYINSTEX yang menentukan data yang diperluas.

Jika AttachPropertyInstanceEx dipanggil dan tidak ada data yang diperluas yang disediakan, parameter lpDataEx adalah NULL atau parameter LengthEx adalah 0, panggilan AttachPropertyInstanceEx secara fungsional setara dengan panggilan AttachPropertyInstance .

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.

Persyaratan