Fungsi SnmpGetRetry (winsnmp.h)

Artikel
03/04/2024

[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 WinSNMP SnmpGetRetry mengembalikan nilai jumlah coba lagi, dalam satuan, untuk transmisi ulang permintaan pesan SNMP. Jumlah coba lagi berlaku untuk panggilan yang dilakukan aplikasi WinSNMP ke fungsi SnmpSendMsg untuk entitas manajemen tertentu.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetry(
  [in]  HSNMP_ENTITY hEntity,
  [out] smiLPUINT32  nPolicyRetry,
  [out] smiLPUINT32  nActualRetry
);

Parameter

[in] hEntity

Tangani ke entitas manajemen tujuan yang diminati.

[out] nPolicyRetry

Arahkan ke variabel bilangan bulat panjang yang tidak ditandatangani untuk menerima nilai jumlah coba lagi untuk entitas manajemen yang ditentukan. Ini adalah nilai yang disimpan implementasi Microsoft WinSNMP dalam database. Jika Anda tidak memerlukan informasi yang dikembalikan dalam parameter ini, nPolicyRetry harus berupa penunjuk NULL .

[out] nActualRetry

Arahkan ke variabel bilangan bulat panjang yang tidak ditandatangani untuk menerima jumlah coba lagi aktual atau perkiraan terakhir untuk entitas tujuan, seperti yang dilaporkan oleh implementasi. Jika Anda tidak memerlukan informasi yang dikembalikan dalam parameter ini, nActualRetry harus menjadi penunjuk NULL . Jika parameter ini adalah penunjuk yang valid, fungsi mengembalikan 0. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan SNMPAPI_SUCCESS.

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.

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_NOOP	Parameter nPolicyRetry dan nActualRetry adalah NULL. Operasi tidak dilakukan.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Biasanya aplikasi WinSNMP, daripada aplikasi agen, memanggil fungsi SnmpGetRetry .

Aplikasi WinSNMP dapat memodifikasi nilai jumlah coba lagi dengan panggilan ke fungsi SnmpSetRetry .

Aplikasi WinSNMP dapat memantau nilai parameter nActualRetry dan membandingkannya dengan nilai parameter nPolicyRetry untuk mengoptimalkan performa transmisi. 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

SnmpSetRetransmitMode

SnmpSetRetry

Fungsi WinSNMP

Gambaran Umum API WinSNMP

Bagikan melalui