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

Fungsi SnmpMgrOpen menginisialisasi soket komunikasi dan struktur data, memungkinkan komunikasi dengan agen SNMP yang ditentukan. Fungsi ini adalah elemen dari SNMP Management API.

Sintaks

LPSNMP_MGR_SESSION SNMP_FUNC_TYPE SnmpMgrOpen(
  [in] LPSTR lpAgentAddress,
  [in] LPSTR lpAgentCommunity,
  [in] INT   nTimeOut,
  [in] INT   nRetries
);

Parameter

[in] lpAgentAddress

Penunjuk ke string yang dihentikan null yang menentukan nama host atau alamat IP. Nama host harus diselesaikan ke alamat IP, alamat IPX (dalam notasi 8.12), atau alamat ethernet. Lihat bagian Keterangan untuk formulir yang dapat diterima untuk nama host dan alamat IP.

[in] lpAgentCommunity

Penunjuk ke string yang dihentikan null yang menentukan nama komunitas SNMP untuk digunakan saat berkomunikasi dengan agen yang diidentifikasi oleh parameter lpAgentAddress .

[in] nTimeOut

Menentukan batas waktu komunikasi dalam milidetik.

[in] nRetries

Menentukan jumlah coba lagi komunikasi. Waktu habis yang ditentukan dalam parameter nTimeOut digandakan setiap kali upaya coba lagi dikirimkan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke struktur LPSNMP_MGR_SESSION . Struktur ini digunakan secara internal dan programmer tidak boleh mengubahnya. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. GetLastError dapat mengembalikan kode kesalahan SNMP_MEM_ALLOC_ERROR, yang menunjukkan kesalahan alokasi memori.

Fungsi ini juga dapat mengembalikan kode kesalahan Windows Sockets.

Keterangan

Jika memungkinkan, gunakan nama host untuk mengidentifikasi agen SNMP di parameter lpAgentAddress . Nama host dapat disediakan untuk agen hanya jika TCP/IP dimuat dan namanya adalah nama host TCP/IP. Nama NetBIOS tidak dapat disediakan untuk host IPX.

Nama dan alamat target SNMP, atau string yang diarahkan oleh parameter lpAgentAddress , harus sesuai dengan salah satu formulir berikut.

Aplikasi tidak boleh menggunakan penunjuk LPSNMP_MGR_SESSION yang dikembalikan oleh fungsi ini untuk memanggil fungsi SnmpMgrRequest dalam konteks utas yang berbeda.

Persyaratan

Lihat juga

Fungsi SNMP

Gambaran Umum Simple Network Management Protocol (SNMP)

SnmpMgrClose

SnmpMgrRequest