Fungsi SnmpExtensionInit (snmp.h)

[SNMP tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan Manajemen Jarak Jauh Windows, yang merupakan implementasi Microsoft dari WS-Man.]

Layanan Microsoft SNMP memanggil fungsi SnmpExtensionInit untuk menginisialisasi DLL agen ekstensi SNMP. Fungsi ini adalah elemen dari API Agen Ekstensi SNMP.

Sintaks

BOOL SNMP_FUNC_TYPE SnmpExtensionInit(
  [in]  DWORD               dwUptimeReference,
  [out] HANDLE              *phSubagentTrapEvent,
  [out] AsnObjectIdentifier *pFirstSupportedRegion
);

Parameter

[in] dwUptimeReference

Menentukan referensi time-zero untuk agen ekstensi.

[out] phSubagentTrapEvent

Penunjuk ke peristiwa menangani agen ekstensi yang diteruskan kembali ke layanan SNMP. Handel ini digunakan untuk memberi tahu layanan bahwa agen ekstensi memiliki satu atau beberapa perangkap untuk dikirim. Untuk informasi tambahan tentang mengalokasikan dan membatalkan alokasi penanganan aktivitas, lihat bagian Keterangan berikut.

[out] pFirstSupportedRegion

Arahkan ke struktur Pengidentifikasi AsnObjectI untuk menerima subtree MIB pertama yang didukung agen ekstensi. Untuk informasi tambahan tentang mengalokasikan dan membatalkan alokasi sumber daya untuk struktur ini, lihat bagian Keterangan berikut.

Agen ekstensi dapat mendaftarkan subtrees MIB tambahan dengan mengimplementasikan fungsi titik masuk SnmpExtensionInitEx .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE.

Keterangan

Agen ekstensi harus mengabaikan parameter dwUptimeReference . Sebagai gantinya, mereka harus memanggil fungsi SnmpSvcGetUptime untuk mengambil jumlah sentidetik yang telah dijalankan layanan Microsoft SNMP. Karena parameter dwUptimeReference menyimpan waktu yang berlalu sebagai nilai DWORD dalam milidetik, waktu dapat membungkus ke nol dan mencerminkan interval waktu yang tidak akurat.

Agen ekstensi memberi tahu layanan SNMP bahwa ia perlu mengirim satu atau beberapa perangkap dengan mengatur handel peristiwa yang diteruskan kembali dalam parameter phSubagentTrapEvent ke status yang disinyalir. Setelah peristiwa ini disinyalir, layanan SNMP berulang kali memanggil titik entri SnmpExtensionTrap agen ekstensi hingga fungsi mengembalikan nilai FALSE. Ini menunjukkan bahwa agen ekstensi tidak memiliki lebih banyak perangkap untuk dikirim. Jika agen ekstensi tidak menghasilkan trap, parameter phSubagentTrapEvent harus mengembalikan nilai NULL.

Agen ekstensi SNMP harus mengalokasikan dan membatalkan alokasi sumber daya untuk handel peristiwa trap. Ketika layanan SNMP memanggil fungsi SnmpExtensionInit , agen ekstensi harus memanggil fungsi CreateEvent untuk mengalokasikan handel peristiwa. Agen ekstensi meneruskan handel ke layanan SNMP di parameter phSubagentTrapEvent . Ketika layanan SNMP memanggil fungsi SnmpExtensionClose , agen ekstensi harus membatalkan alokasi sumber daya untuk handel peristiwa trap.

Layanan SNMP membuat salinan struktur AsnObjectIdentifier yang dikembalikan agen ekstensi dalam parameter pFirstSupportedRegion . Agen ekstensi harus mengalokasikan dan membatalkan alokasi sumber daya yang terkait dengan struktur asli. Ini dapat melakukan ini ketika layanan SNMP memanggil fungsi SnmpExtensionClose .

Persyaratan

Lihat juga

AsnObjectIdentifier

CreateEvent

Fungsi SNMP

Gambaran Umum Simple Network Management Protocol (SNMP)

SnmpExtensionClose

SnmpExtensionMonitor

SnmpExtensionTrap

SnmpSvcGetUptime