Fungsi SnmpStrToOid (winsnmp.h)

Artikel
08/27/2023

[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 SnmpStrToOid mengonversi format string numerik putus-putus dari pengidentifikasi objek SNMP, misalnya, "1.2.3.4.5.6", ke representasi biner internalnya.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpStrToOid(
  [in]  LPCSTR   string,
  [out] smiLPOID dstOID
);

Parameter

[in] string

Penunjuk ke string pengidentifikasi objek yang dihentikan null untuk dikonversi.

[out] dstOID

Penunjuk ke struktur smiOID yang menerima nilai yang dikonversi.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah subidentifier dalam pengidentifikasi objek yang dikonversi. Angka ini juga merupakan nilai anggota len dari struktur smiOID yang diarahkan oleh parameter dstOID .

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_OID_INVALID	Parameter string tidak valid. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Aplikasi WinSNMP harus memanggil fungsi SnmpFreeDescriptor ke sumber daya gratis yang dialokasikan untuk anggota ptr struktur smiOID yang ditujukkan oleh parameter dstOID . Pada input, SnmpFreeDescriptor mengabaikan anggota struktur smiOID ini. Implementasi Microsoft WinSNMP menimpa anggota smiOID jika fungsi berhasil diselesaikan.

Fungsi SnmpStrToOid gagal dan mengembalikan kode kesalahan SNMPAPI_OID_INVALID jika parameter string memenuhi salah satu kondisi berikut:

Tidak dihentikan null.
Bukan bentuk tekstual dari pengidentifikasi objek yang valid.
Panjangnya tidak mencukup; semua pengidentifikasi objek harus memiliki dua subidentifikasi.
Melebihi MAXOBJIDSTRSIZE sebesar 1408 byte.

Untuk informasi tambahan, lihat Konsep Manajemen Data WinSNMP dan Membebaskan Deskriptor 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

Lihat juga

SnmpFreeDescriptor

Fungsi WinSNMP

Gambaran Umum API WinSNMP

smiOID

Bagikan melalui