Fungsi SnmpStrToEntity (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 SnmpStrToEntity mengembalikan handel ke informasi tentang entitas manajemen SNMP yang khusus untuk implementasi Microsoft WinSNMP.

Sintaks

HSNMP_ENTITY SNMPAPI_CALL SnmpStrToEntity(
  [in] HSNMP_SESSION session,
  [in] LPCSTR        string
);

Parameter

[in] session

Tangani ke sesi WinSNMP.

[in] string

Penunjuk ke string yang dihentikan null yang mengidentifikasi entitas manajemen SNMP yang diminati. Pengaturan saat ini dari entitas dan mode terjemahan konteks menentukan cara SnmpStrToEntity menginterpretasikan string input sebagai berikut.

Mode Terjemahan Entitas/Konteks	Makna
SNMPAPI_TRANSLATED	Implementasi menginterpretasikan parameter string sebagai nama yang mudah digunakan. Implementasi menerjemahkan nama ke dalam komponen SNMPv1 atau SNMPv2C menggunakan database implementasi.
SNMPAPI_UNTRANSLATED_V1	Implementasi menginterpretasikan parameter string sebagai alamat transportasi SNMP harfiah.
SNMPAPI_UNTRANSLATED_V2	Implementasi menginterpretasikan parameter string sebagai alamat transportasi SNMP harfiah.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah handel ke entitas manajemen SNMP yang diminati.

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_SESSION_INVALID	Parameter sesi tidak valid.
SNMPAPI_ENTITY_UNKNOWN	String entitas tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Pengaturan entitas dan mode terjemahan konteks saat ini menentukan cara SnmpStrToEntity menginterpretasikan string input yang mengidentifikasi entitas manajemen yang diminati. Untuk informasi tambahan, lihat Dukungan untuk String Alamat IPX di WinSNMP dan Mengatur Mode Terjemahan Entitas dan Konteks.

Aplikasi WinSNMP harus memanggil fungsi SnmpFreeEntity untuk merilis handel entitas yang dialokasikan oleh fungsi SnmpStrToEntity . Untuk informasi tambahan, lihat Konsep Manajemen Data WinSNMP.

Fungsi SnmpStrToEntity mengembalikan handel entitas yang valid yang dapat digunakan aplikasi WinSNMP sebagai srcEntity atau parameter dstEntity dalam beberapa fungsi WinSNMP. Fungsi-fungsi ini termasuk fungsi SnmpSendMsg, SnmpRecvMsg, SnmpRegister, SnmpEncodeMsg, dan SnmpDecodeMsg .

Implementasi mengembalikan entitas saat ini dan mode terjemahan konteks dalam parameter nTranslateMode dari fungsi SnmpStartup . Aplikasi WinSNMP dapat mengubah pengaturan entitas dan mode terjemahan konteks dengan panggilan ke fungsi SnmpSetTranslateMode .

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