struktur smiVALUE (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.]

Struktur WinSNMP smiVALUE menjelaskan nilai yang terkait dengan nama variabel dalam entri pengikatan variabel.

Anggota sintaks struktur smiVALUE berisi jenis data WinSNMP yang menunjukkan jenis data dalam anggota nilai . Anggota nilai struktur adalah penyatuan semua kemungkinan jenis data WinSNMP.

Sintaks

typedef struct {
  smiUINT32 syntax;
  union {
    smiINT    sNumber;
    smiUINT32 uNumber;
    smiCNTR64 hNumber;
    smiOCTETS string;
    smiOID    oid;
    smiBYTE   empty;
  } value;
} smiVALUE, *smiLPVALUE;

Anggota

syntax

Jenis: smiUINT32

Menentukan bilangan bulat panjang yang tidak ditandatangani yang menunjukkan jenis data sintaks anggota nilai . Anggota ini hanya bisa menjadi salah satu tipe yang tercantum dalam tabel berikut ini. Untuk informasi selengkapnya, lihat Jenis Data WinSNMP dan RFC 1902, "Struktur Informasi Manajemen untuk Versi 2 dari Protokol Manajemen Jaringan Sederhana (SNMPv2)."

Jenis data sintaks	Makna
SNMP_SYNTAX_INT	Menunjukkan variabel bilangan bulat bertanda tangan 32-bit.
SNMP_SYNTAX_OCTETS	Menunjukkan variabel string oktet yang merupakan data biner atau tekstual.
SNMP_SYNTAX_NULL	Menunjukkan nilai NULL .
SNMP_SYNTAX_OID	Menunjukkan variabel pengidentifikasi objek yang merupakan nama yang ditetapkan dengan maksimum 128 subidentifier.
SNMP_SYNTAX_INT32	Menunjukkan variabel bilangan bulat bertanda tangan 32-bit.
SNMP_SYNTAX_IPADDR	Menunjukkan variabel alamat Internet 32-bit.
SNMP_SYNTAX_CNTR32	Menunjukkan variabel penghitung yang meningkat hingga mencapai nilai maksimum (2^32) – 1.
SNMP_SYNTAX_GAUGE32	Menunjukkan variabel pengukur yang merupakan bilangan bulat non-negatif yang dapat meningkat atau berkurang, tetapi tidak pernah melebihi nilai maksimum.
SNMP_SYNTAX_TIMETICKS	Menunjukkan variabel penghitung yang mengukur waktu dalam seratus detik, sampai mencapai nilai maksimum (2^32) – 1. Ini adalah bilangan bulat non-negatif yang relatif terhadap peristiwa timer tertentu.
SNMP_SYNTAX_OPAQUE	Jenis ini memberikan kompatibilitas mundur, dan tidak boleh digunakan untuk jenis objek baru. Ini mendukung kemampuan untuk meneruskan sintaks Abstract Syntax Notation One (ASN.1) arbitrer.
SNMP_SYNTAX_CNTR64	Menunjukkan variabel penghitung yang meningkat hingga mencapai nilai maksimum (2^64) – 1.
SNMP_SYNTAX_UINT32	Menunjukkan variabel bilangan bulat yang tidak ditandatangani 32-bit.
SNMP_SYNTAX_NOSUCHOBJECT	Menunjukkan bahwa agen tidak mendukung jenis objek yang sesuai dengan variabel.
SNMP_SYNTAX_NOSUCHINSTANCE	Menunjukkan bahwa instans objek tidak ada untuk operasi.
SNMP_SYNTAX_ENDOFMIBVIEW	Menunjukkan aplikasi WinSNMP mencoba mereferensikan pengidentifikasi objek yang berada di luar akhir pohon MIB yang didukung agen.

Tiga jenis sintaks terakhir menjelaskan kondisi pengecualian dalam kerangka kerja SNMP versi 2C (SNMPv2C).

value

Menentukan penyatuan semua kemungkinan jenis data sintaks WinSNMP, termasuk jenis deskriptor smiOID atau smiOCTETS .

sNumber

Jenis: smiINT Menentukan nilai bilangan bulat panjang yang ditandatangani.

uNumber

Jenis: smiUINT32 Menentukan nilai bilangan bulat panjang yang tidak ditandatangani 32-bit.

hNumber

Jenis: smiCNTR64 Menentukan nilai bilangan bulat tidak bertanda 64-bit

string

Jenis: smiOCTETS Menentukan string.

oid

Jenis: smiOID Menentukan pengidentifikasi objek (OID).

kosong

Jenis: smiBYTE Menentukan anggota kosong.

value.sNumber

value.uNumber

value.hNumber

value.string

value.oid

value.empty

Keterangan

Aplikasi WinSNMP harus memeriksa anggota sintaks struktur smiVALUE untuk mendereferensikan anggota nilai dengan benar. Anggota nilai dapat berisi nilai skalar sederhana atau nilai non-skalar seperti smiOCTETS atau struktur deskriptor smiOID .

Jika anggota sintaks menunjukkan bahwa anggota nilai adalah smiOCTETS atau struktur deskriptor smiOID , aplikasi WinSNMP harus menentukan apakah akan membebaskan sumber daya yang dialokasikan untuk struktur. Implementasi Microsoft WinSNMP mengalokasikan dan membatalkan alokasi memori untuk semua struktur smiOCTETS dan smiOID output. Aplikasi harus memanggil fungsi SnmpFreeDescriptor untuk membebaskan memori bagi anggota ptr struktur ini.

Karena aplikasi WinSNMP mengalokasikan memori untuk deskriptor input dengan panjang variabel, aplikasi harus membebaskan memori tersebut. Untuk informasi selengkapnya, lihat Konsep Manajemen Data WinSNMP.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	winsnmp.h