Fungsi SnmpOidCompare (winsnmp.h)

Artikel
08/27/2023

[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 SnmpOidCompare secara leksikografis membandingkan dua pengidentifikasi objek SNMP, hingga panjang yang ditentukan oleh parameter maxlen .

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCompare(
  [in]  smiLPCOID xOID,
  [in]  smiLPCOID yOID,
  [in]  smiUINT32 maxlen,
  [out] smiLPINT  result
);

Parameter

[in] xOID

Arahkan ke pengidentifikasi objek smiOID pertama untuk dibandingkan. Panjang pengidentifikasi objek bisa nol.

[in] yOID

Arahkan ke pengidentifikasi objek smiOID kedua untuk dibandingkan. Panjang pengidentifikasi objek bisa nol.

[in] maxlen

Jika tidak sama dengan nol, menentukan jumlah subidentifier yang akan dibandingkan. Parameter ini harus kurang dari MAXOBJIDSIZE: 128 subidentifiers, jumlah maksimum komponen dalam pengidentifikasi objek. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.

[out] result

Arahkan ke variabel bilangan bulat untuk menerima hasil perbandingan. Variabel dapat menerima salah satu hasil berikut.

Hasil	Makna
Lebih besar dari 0	xOID lebih besar dari yOID
Sama dengan 0	xOID sama dengan yOID
Kurang dari 0	xOID kurang dari yOID

Untuk kondisi perbandingan tambahan, lihat bagian Keterangan berikut ini.

Mengembalikan nilai

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_OID_INVALID	Satu atau kedua parameter xOID dan yOID tidak valid.
SNMPAPI_SIZE_INVALID	Parameter maxlen tidak valid. Ukuran parameter lebih besar dari MAXOBJIDSIZE.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Aplikasi WinSNMP dapat memanggil fungsi SnmpOidCompare untuk menentukan apakah dua pengidentifikasi objek memiliki awalan umum.

Jika parameter maxlen tidak sama dengan nol, dan tidak lebih besar dari MAXOBJIDSIZE, nilai maxlen menetapkan batas atas untuk jumlah subidentifier yang akan dibandingkan. Jumlah maksimum subidentifier yang fungsi SnmpOidCompare membandingkan default dengan angka terkecil mana pun—parameter maxlen , atau anggota len dari salah satu struktur smiOID yang ditunjukkan oleh parameter xOID dan yOID .

Jika parameter maxlen sama dengan nol, jumlah maksimum subidentifier yang fungsi SnmpOidCompare membandingkan default dengan angka yang lebih kecil dari anggota lensa dari dua struktur smiOID .

Nilai parameter hasil akan menunjukkan bahwa xOID sama dengan yOID jika kedua struktur smiOID secara leksikografis sama dan salah satu hal berikut ini terjadi:

SnmpOidCompare membandingkan jumlah maksimum subidentifier.
SnmpOidCompare membandingkan jumlah maksimum subidentifier, dan anggota lensa dari kedua struktur smiOID sama, tetapi kurang dari parameter maxlen .

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

Fungsi WinSNMP

Gambaran Umum API WinSNMP

smiOID

Bagikan melalui