Fungsi SnmpStartupEx (winsnmp.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.]
Fungsi SnmpStartupEx memberi tahu implementasi Microsoft WinSNMP bahwa aplikasi WinSNMP memerlukan layanan implementasi. Fungsi WinSNMP SnmpStartupEx memungkinkan implementasi untuk menginisialisasi dan kembali ke aplikasi versi Windows SNMP Application Programming Interface (WinSNMP API), tingkat komunikasi SNMP yang didukung implementasi, dan mode terjemahan dan transmisi ulang default implementasi.
Fungsi ini harus digunakan alih-alih SnmpStartup jika Windows Server 2003 dengan Paket Layanan 1 (SP1) atau yang lebih baru diinstal. SnmpStartupEx memungkinkan dukungan untuk beberapa modul perangkat lunak independen yang menggunakan WinSNMP dalam aplikasi yang sama.
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpStartupEx(
[out] smiLPUINT32 nMajorVersion,
[out] smiLPUINT32 nMinorVersion,
[out] smiLPUINT32 nLevel,
[out] smiLPUINT32 nTranslateMode,
[out] smiLPUINT32 nRetransmitMode
);
Parameter
[out] nMajorVersion
Arahkan ke variabel bilangan bulat panjang yang tidak ditandatangani untuk menerima nomor versi utama API WinSNMP yang didukung implementasi. Misalnya, untuk menunjukkan bahwa implementasi mendukung WinSNMP versi 2.0, fungsi mengembalikan nilai 2.
[out] nMinorVersion
Arahkan ke variabel bilangan bulat panjang yang tidak ditandatangani untuk menerima nomor versi minor api WinSNMP yang didukung implementasi. Misalnya, untuk menunjukkan bahwa implementasi mendukung WinSNMP versi 2.0, fungsi mengembalikan nilai 0.
[out] nLevel
Arahkan ke variabel bilangan bulat panjang yang tidak ditandatangani untuk menerima tingkat komunikasi SNMP tertinggi yang didukung implementasi. Setelah berhasil dikembalikan, parameter ini berisi nilai 2. Untuk deskripsi dukungan tingkat 2, lihat Tingkat Dukungan SNMP.
[out] nTranslateMode
Penunjuk ke variabel bilangan bulat panjang yang tidak ditandatangani untuk menerima mode terjemahan default yang berlaku untuk implementasi. Mode terjemahan berlaku untuk bagaimana implementasi menginterpretasikan parameter entitas , yang diteruskan aplikasi WinSNMP ke fungsi SnmpStrToEntity . Mode terjemahan juga berlaku untuk parameter string yang diteruskan aplikasi WinSNMP ke fungsi SnmpStrToContext . Parameter ini bisa menjadi salah satu nilai berikut.
Untuk informasi tambahan, lihat Mengatur Mode Terjemahan Entitas dan Konteks.
[out] nRetransmitMode
Penunjuk ke variabel bilangan bulat panjang yang tidak ditandatangani untuk menerima mode transmisi ulang default yang berlaku untuk implementasi. Parameter ini bisa menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
|
Implementasinya tidak menjalankan kebijakan transmisi ulang aplikasi WinSNMP. |
|
Implementasinya adalah menjalankan kebijakan transmisi ulang aplikasi WinSNMP. |
Untuk informasi tambahan, lihat Tentang Transmisi Ulang.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan SNMPAPI_SUCCESS, dan parameter berisi nilai yang sesuai, seperti yang ditunjukkan dalam deskripsi parameter sebelumnya.
Jika fungsi gagal, nilai yang dikembalikan SNMPAPI_FAILURE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil SnmpGetLastError yang menentukan nilai NULL dalam parameter sesinya . Fungsi SnmpGetLastError dapat mengembalikan salah satu kesalahan berikut. Untuk informasi tambahan, lihat bagian "Keterangan" nanti di dokumen ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Terjadi kesalahan alokasi sumber daya selama startup. |
|
Fungsi SnmpStartupEx tidak menginisialisasi dengan benar. |
|
Terjadi kesalahan selama alokasi memori. |
|
Terjadi kesalahan yang tidak diketahui atau tidak terdefinis. |
Keterangan
Aplikasi WinSNMP harus memanggil fungsi SnmpStartupEx dengan sukses setidaknya sekali, sebelum memanggil fungsi WinSNMP lainnya. Jika aplikasi WinSNMP memanggil fungsi WinSNMP lain sebelum berhasil memanggil SnmpStartupEx, implementasi mengembalikan kesalahan SNMPAPI_NOT_INITIALIZED.
Aplikasi WinSNMP dapat memanggil SnmpGetLastError untuk informasi kesalahan, atau mencoba kembali SnmpStartupEx jika panggilan ke fungsi SnmpStartupEx gagal. Ketika SnmpStartupEx mengembalikan SNMPAPI_FAILURE, dan panggilan berikutnya ke SnmpGetLastError mengembalikan SNMP_ALLOC_ERROR, aplikasi WinSNMP dapat memilih untuk menunggu. Ini dapat mencoba kembali panggilan ke SnmpStartupEx ketika implementasi memiliki sumber daya gratis yang memadai.
Aplikasi WinSNMP harus memanggil SnmpCleanupEx untuk setiap panggilan yang berhasil ke SnmpStartupEx. Implementasi WinSNMP melakukan pembersihan akhir di mana tidak ada panggilan sukses yang luar biasa ke SnmpStartup atau SnmpStartupEx.
Untuk informasi tambahan, lihat Tingkat Dukungan SNMP dan Tentang Versi SNMP.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winsnmp.h |
| Pustaka | Wsnmp32.lib |
| DLL | Wsnmp32.dll |