Fungsi SnmpUtilIdsToA (snmp.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 SnmpUtilIdsToA mengonversi pengidentifikasi objek (OID) menjadi string yang dihentikan null. Fungsi ini adalah elemen dari SNMP Utility API.

Sintaks

LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
  [in] UINT *Ids,
  [in] UINT IdLength
);

Parameter

[in] Ids

Penunjuk ke array bilangan bulat yang tidak ditandatangani. Array berisi urutan angka yang dikandung OID. Parameter IdLength menentukan panjang array.

Untuk informasi selengkapnya, lihat bagian Mengembalikan Nilai dan Keterangan berikut ini.

[in] IdLength

Menentukan jumlah elemen dalam array yang ditujukkan oleh parameter Id .

Mengembalikan nilai

Fungsi mengembalikan string yang dihentikan null yang berisi representasi string dari array angka yang ditunjukkan oleh parameter Ids . String berisi urutan angka yang dipisahkan oleh titik ('.'); misalnya, 1.3.6.1.4.1.311.

Jika parameter Ids null, atau jika parameter IdLength menentukan nol, fungsi mengembalikan string "<null oid>".

Panjang maksimum string yang dikembalikan adalah 256 karakter. Jika panjang string melebihi 256 karakter, string dipotong dan dihentikan dengan urutan tiga periode ('...').

Keterangan

Fungsi SnmpUtilIdsToA dapat membantu penelusuran kesalahan aplikasi SNMP.

Perhatikan bahwa pembatasan memori berikut berlaku saat Anda memanggil SnmpUtilIdsToA:

• Parameter Id harus menunjuk ke blok memori yang valid setidaknya bilangan bulat IdLength , atau panggilan fungsi menghasilkan pengecualian pelanggaran akses.
• String yang dikembalikan oleh SnmpUtilIdsToA berada dalam memori yang dialokasikan SNMP Utility API. Aplikasi tidak boleh membuat asumsi tentang alokasi memori. Data dijamin valid sampai Anda memanggil SnmpUtilIdsToA lagi, jadi sebelum memanggil fungsi lagi, Anda harus menyalin data ke lokasi lain.

Persyaratan

Lihat juga

Fungsi SNMP

Gambaran Umum Simple Network Management Protocol (SNMP)

SnmpUtilOidToA