Fungsi SnmpContextToStr (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 SnmpContextToStr mengembalikan string yang mengidentifikasi konteks SNMP, yang merupakan sekumpulan sumber daya objek terkelola. Fungsi mengembalikan string dalam struktur smiOCTETS .

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpContextToStr(
  [in]  HSNMP_CONTEXT context,
  [out] smiLPOCTETS   string
);

Parameter

[in] context

Tangani konteks minat SNMP.

[out] string

Arahkan ke struktur smiOCTETS untuk menerima string yang mengidentifikasi konteks yang diminati. String dapat memiliki byte null-terminating.

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, hubungi SnmpGetLastError. 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_CONTEXT_INVALID	Parameter konteks tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Pengaturan saat ini dari entitas dan mode terjemahan konteks menentukan jenis string output yang dikembalikan SnmpContextToStr . Untuk informasi tambahan, lihat Mengatur Mode Terjemahan Entitas dan Konteks.

Aplikasi WinSNMP harus menyediakan alamat struktur smiOCTETS yang valid untuk parameter string . Jika fungsi SnmpContextToStr berhasil diselesaikan, implementasi Microsoft WinSNMP menginisialisasi len dan anggotaptr struktur. Aplikasi WinSNMP harus memanggil fungsi SnmpFreeDescriptor untuk memungkinkan implementasi membebaskan sumber daya bagi anggota ini.

Ketika mode terjemahan entitas dan konteks SNMPAPI_TRANSLATED, dan entri ada dalam database implementasi, implementasi mengembalikan nama konteks yang mudah digunakan terkait. Jika entri tidak ada untuk nama konteks, SnmpContextToStr mengembalikan string komunitas SNMP.

Ketika mode terjemahan entitas dan konteks SNMPAPI_UNTRANSLATED_V1 atau SNMPAPI_UNTRANSLATED_V2, implementasinya juga mengembalikan string komunitas SNMP.

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

smiOCTETS

Bagikan melalui