Fungsi SnmpSetPort (winsnmp.h)
[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.]
Aplikasi WinSNMP memanggil fungsi SnmpSetPort untuk mengubah port yang ditetapkan ke entitas tujuan. Fungsi SnmpSetPort adalah elemen dari WINSNMP API, versi 2.0.
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetPort(
[in] HSNMP_ENTITY hEntity,
[in] UINT nPort
);
Parameter
[in] hEntity
Menangani ke entitas tujuan WinSNMP. Parameter ini dapat menentukan handel ke entitas yang bertindak dalam peran aplikasi agen SNMP sebagai hasil dari panggilan ke fungsi SnmpListen . Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
[in] nPort
Menentukan bilangan bulat yang tidak ditandatangani yang mengidentifikasi penetapan port baru untuk entitas tujuan. Jika Anda menentukan alamat lokal yang sibuk, atau jika Anda menentukan alamat jarak jauh yang tidak tersedia, panggilan ke fungsi SnmpSetPort gagal.
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 |
|---|---|
|
Fungsi SnmpStartup tidak berhasil diselesaikan. |
|
Entitas yang ditentukan oleh parameter hEntity sudah berfungsi dalam peran agen sebagai hasil dari panggilan ke fungsi SnmpListen . Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini. |
|
Parameter hEntity tidak valid. Parameter ini harus berupa handel yang dikembalikan oleh panggilan sebelumnya ke fungsi SnmpStrToEntity . |
|
Terjadi kesalahan yang tidak diketahui atau tidak terdefinis. |
Keterangan
Implementasi Microsoft WinSNMP menetapkan port ke setiap entitas manajemen sebagai hasil dari panggilan aplikasi WinSNMP ke fungsi SnmpStrToEntity . Jika mode SNMPAPI_UNTRANSLATED berlaku saat implementasi membuat entitas, implementasi biasanya menetapkan port permintaan SNMP standar untuk keluarga protokol masing-masing ke entitas; misalnya, UDP 161 atau IPX 36879. Jika mode SNMPAPI_TRANSLATED berlaku, implementasi menetapkan port yang ditentukan untuk entitas dalam database WinSNMP. Untuk mengambil entitas saat ini dan mode terjemahan konteks yang berlaku untuk implementasi, aplikasi dapat memanggil fungsi SnmpGetTranslateMode . Untuk informasi selengkapnya, lihat Mengatur Mode Terjemahan Entitas dan Konteks dan Database WinSNMP.
Panggilan ke fungsi SnmpSetPort gagal jika entitas yang ditentukan oleh parameter hEntity saat ini berfungsi dalam peran agen. Ini karena entitas telah ditetapkan ke port selain yang ditentukan oleh parameter nPort . Untuk memastikan penugasan aplikasi agen ke port tertentu, aplikasi WinSNMP dapat melakukan langkah-langkah berikut.
-
Panggil SnmpStrToEntity sebagai berikut:
hAgent = SnmpStrToEntity (hSession, <addrString>); -
Panggil SnmpSetPort sebagai berikut:
SnmpSetPort (hAgent, <nPort>); -
Panggil SnmpListen sebagai berikut:
SnmpListen (hAgent, SNMPAPI_ON);
Perhatikan bahwa alamat IPX berisi nomor jaringan yang terdiri dari delapan digit heksadesimal (diisi nol jika perlu); pemisah (baik ":", "." atau " – "); dan nomor simpul yang terdiri dari 12 digit heksadesimal (tidak terisi jika perlu)—misalnya, 00000001:00081A0D01C2. Untuk informasi selengkapnya, lihat Dukungan untuk String Alamat IPX di WinSNMP.
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 |