Fungsi SnmpGetTimeout (winsnmp.h)

Artikel
03/04/2024

[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 SnmpGetTimeout mengembalikan nilai waktu habis, dalam seratus detik, untuk transmisi permintaan pesan SNMP. Nilai waktu habis berlaku untuk panggilan yang dilakukan aplikasi WinSNMP ke fungsi SnmpSendMsg untuk entitas manajemen tertentu.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTimeout(
  [in]  HSNMP_ENTITY   hEntity,
  [out] smiLPTIMETICKS nPolicyTimeout,
  [out] smiLPTIMETICKS nActualTimeout
);

Parameter

[in] hEntity

Tangani entitas manajemen tujuan yang diminati.

[out] nPolicyTimeout

Arahkan ke variabel bilangan bulat untuk menerima nilai waktu habis, dalam sepersekian detik, 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 menjadi penunjuk NULL .

[out] nActualTimeout

Arahkan ke variabel bilangan bulat untuk menerima interval respons 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 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_NOOP	Parameter nPolicyRetry dan nActualRetry keduanya adalah NULL. Operasi tidak dilakukan.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Biasanya aplikasi WinSNMP, bukan aplikasi agen, memanggil fungsi SnmpGetTimeout .

Periode waktu habis adalah interval antara panggilan aplikasi ke fungsi SnmpSendMsg dan panggilannya ke fungsi SnmpRecvMsg .

Aplikasi WinSNMP dapat memodifikasi nilai waktu habis dengan panggilan ke fungsi SnmpSetTimeout .

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

SnmpSetTimeout

Fungsi WinSNMP

Gambaran Umum API WinSNMP

Bagikan melalui