Fungsi SnmpCancelMsg (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.]

Aplikasi WinSNMP memanggil fungsi SnmpCancelMsg untuk meminta implementasi Microsoft WinSNMP membatalkan upaya transmisi ulang dan pemberitahuan waktu habis untuk pesan permintaan SNMP. Fungsi SnmpCancelMsg adalah elemen dari WinSNMP API, versi 2.0.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpCancelMsg(
  [in] HSNMP_SESSION session,
  [in] smiINT32      reqId
);

Parameter

[in] session

Tangani sesi WinSNMP yang mengirimkan pesan permintaan SNMP (PDU) untuk dibatalkan.

[in] reqId

Menentukan nilai numerik unik yang mengidentifikasi PDU yang menarik. Parameter ini harus cocok dengan pengidentifikasi permintaan (request_id) dari parameter PDU yang ditentukan dalam panggilan awal aplikasi ke fungsi SnmpSendMsg .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan SNMPAPI_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan SNMPAPI_FAILURE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil SnmpGetLastError. Fungsi SnmpGetLastError dapat mengembalikan salah satu kesalahan berikut.

Menampilkan kode	Deskripsi
SNMPAPI_SESSION_INVALID	Parameter sesi tidak valid.
SNMPAPI_PDU_INVALID	Parameter reqId tidak mengidentifikasi pesan yang luar biasa untuk sesi yang ditentukan.
SNMPAPI_NOT_INITIALIZED	Fungsi SnmpStartup tidak berhasil diselesaikan.
SNMPAPI_ALLOC_ERROR	Terjadi kesalahan selama alokasi memori.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

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

Untuk informasi selengkapnya, lihat Membatalkan 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

SnmpSendMsg

SnmpSetRetransmitMode

Fungsi WinSNMP

Gambaran Umum API WinSNMP

Bagikan melalui