Fungsi SnmpSetRetry (winsnmp.h)

Artikel
03/15/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 SnmpSetRetry memungkinkan aplikasi WinSNMP mengubah nilai jumlah coba lagi untuk transmisi ulang permintaan pesan SNMP. Jumlah coba lagi berlaku untuk panggilan yang dilakukan aplikasi WinSNMP ke fungsi SnmpSendMsg untuk entitas manajemen tertentu. Implementasi Microsoft WinSNMP menyimpan nilai dalam database.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetry(
  [in] HSNMP_ENTITY hEntity,
  [in] smiUINT32    nPolicyRetry
);

Parameter

[in] hEntity

Tangani entitas manajemen tujuan yang diminati.

[in] nPolicyRetry

Menentukan nilai baru untuk jumlah coba lagi untuk entitas manajemen. Nilai ini menggantikan nilai yang saat ini disimpan dalam database implementasi.

Jika parameter ini sama dengan nol, dan mode transmisi ulang saat ini sama dengan SNMPAPI_ON, implementasi memilih nilai untuk jumlah coba lagi. Implementasi menggunakan nilai ini ketika menjalankan kebijakan transmisi 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_ENTITY_INVALID	Parameter hEntity tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

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

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

Persyaratan

Persyaratan	Nilai
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

Lihat juga

SnmpGetRetransmitMode

SnmpGetRetry

SnmpSetRetransmitMode

Fungsi WinSNMP

Gambaran Umum API WinSNMP

Bagikan melalui