Fungsi SnmpSetRetransmitMode (winsnmp.h)

Artikel
08/27/2023

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

Fungsi WinSNMP SnmpSetRetransmitMode memungkinkan aplikasi WinSNMP untuk mengatur mode transmisi ulang. Implementasi Microsoft WinSNMP menggunakan mode transmisi ulang baru untuk mengatur batas waktu transmisi dan upaya transmisi ulang pada panggilan berikutnya ke fungsi SnmpSendMsg .

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
  [in] smiUINT32 nRetransmitMode
);

Parameter

[in] nRetransmitMode

Menentukan nilai untuk mode transmisi ulang baru. Parameter ini harus menjadi salah satu nilai berikut.

Nilai	Makna
SNMPAPI_ON	Implementasi menjalankan kebijakan transmisi ulang aplikasi WinSNMP.
SNMPAPI_OFF	Implementasi tidak menjalankan kebijakan pengiriman ulang aplikasi WinSNMP.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah SNMPAPI_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah 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.

Menampilkan kode	Deskripsi
SNMPAPI_NOT_INITIALIZED	Fungsi SnmpStartup tidak berhasil diselesaikan.
SNMPAPI_ALLOC_ERROR	Terjadi kesalahan selama alokasi memori.
SNMPAPI_MODE_INVALID	Implementasi tidak mendukung mode transmisi ulang yang diminta.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Biasanya aplikasi manajer WinSNMP, bukan aplikasi agen, memanggil fungsi SnmpSetRetransmitMode .

Jika aplikasi WinSNMP mengatur mode transmisi ulang ke SNMPAPI_OFF, implementasi tidak memulai upaya transmisi ulang untuk operasi komunikasi SNMP baru. Pengaturan baru memengaruhi semua panggilan berikutnya ke fungsi SnmpSendMsg , hingga aplikasi WinSNMP mengatur mode transmisi ulang kembali ke SNMPAPI_ON.

Memanggil fungsi SnmpCancelMsg setara dengan memanggil fungsi SnmpSetRetransmitMode , untuk pesan SNMP tertentu, dengan mode transmisi ulang sama dengan SNMPAPI_OFF.

Catatan Jika implementasi mengembalikan kesalahan SNMPAPI_MODE_INVALID ke panggilan ke SnmpSetRetransmitMode, aplikasi WinSNMP harus menjalankan kebijakan transmisi ulang.

Untuk informasi tambahan, lihat Tentang Transmisi Ulang dan Mengelola Kebijakan Transmisi Ulang.

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