Fungsi panggilan balik AttachProperties

Fungsi ekspor AttachProperties memetakan properti ke lokasi dalam sepotong data yang dikenali. AttachProperties harus diimplementasikan untuk setiap pengurai yang didukung DLL pengurai.

Sintaks

DWORD AttachProperties(
  _In_ HFRAME    hFrame,
  _In_ LPBYTE    lpFrame,
  _In_ LPBYTE    lpProtocol,
  _In_ DWORD     MacType,
  _In_ DWORD     BytesLeft,
  _In_ HPROTOCOL hPreviousProtocol,
  _In_ DWORD     nPreviousProtocolOffset,
  _In_ DWORD     lpInstData
);

Parameter

hFrame [in]

Handel bingkai yang sedang diurai.

lpFrame [in]

Penunjuk ke byte pertama dalam bingkai.

lpProtocol [in]

Arahkan ke awal data yang dikenali.

MacType [in]

Nilai MAC dari protokol pertama dalam bingkai. MacType dapat berupa salah satu hal berikut ini:

Nilai	Makna
MAC_TYPE_ETHERNET	802.3
MAC_TYPE_TOKENRING	802.5
MAC_TYPE_FDDI	ANSI X3T9.5

BytesLeft [in]

Jumlah byte yang tersisa dalam bingkai yang dimulai dari awal data yang dikenali.

hPreviousProtocol [in]

Menangani protokol sebelumnya.

nPreviousProtocolOffset [in]

Offset protokol sebelumnya dimulai dari awal bingkai.

lpInstData [in]

Arahkan ke data instans yang disediakan protokol sebelumnya. Data instans tidak boleh lebih panjang dari DWORD_PTR panjangnya.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke byte pertama setelah data yang dikenali dalam bingkai atau NULL jika data yang dikenali adalah bagian terakhir data dalam bingkai.

Jika fungsi tidak berhasil, nilai yang dikembalikan adalah penunjuk ke data yang dikenali. Parameter lpProtocol meneruskan pointer ke DLL pengurai.

Keterangan

Monitor Jaringan memanggil fungsi AttachProperties untuk setiap pengurai yang mengenali sepotong data dalam bingkai. Perhatikan bahwa pengurai menentukan properti mana yang ada dalam data yang dikenali, dan di mana setiap properti berada.

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.

Fungsi AttachPropertyInstanceEx dan AttachPropertyInstance hanya dipanggil untuk properti yang ada dalam data yang dikenali. Perhatikan bahwa Monitor Jaringan memiliki database properti untuk pengurai yang berisi deskripsi semua properti yang didukung pengurai.

Data instans

Data instans adalah informasi yang diteruskan dari satu pengurai ke parser lainnya. Data instans dapat berupa data apa pun yang kurang dari atau sama dengan panjang DWORD_PTR, atau penunjuk ke data, seperti data bingkai mentah, yang tidak perlu dialokasikan oleh atau dibebaskan oleh pengurai. Dalam parameter lpInstData dari fungsi AttachProperties dan RecognizeFrame , Monitor Jaringan menyediakan penunjuk ke data instans protokol sebelumnya. Anda dapat mengatur data instans untuk pengurai Anda selama implementasi RecognizeFrame Anda.

Untuk informasi tentang	Lihat
Apa itu pengurai, dan cara kerjanya dengan Monitor Jaringan.	Parser
Titik masuk apa yang disertakan dalam DLL pengurai.	Arsitektur DLL Parser
Cara mengenali data.	Menerapkan RecognizeFrame
Cara membuat database properti.	Menerapkan Register
Cara menerapkan AttachProperties menyertakan contoh.	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

Lihat juga

AttachPropertyInstance

AttachPropertyInstanceEx

RecognizeFrame