Bagikan melalui

Struktur PROPERTYINFO

Struktur data PROPERTYINFO mendefinisikan satu properti protokol.

Sintaks

typedef struct _PROPERTYINFO {
  HPROPERTY hProperty;
  DWORD     Version;
  LPSTR     Label;
  LPSTR     Comment;
  BYTE      DataType;
  BYTE      DataQualifier;
  union {
    LPVOID  lpExtendedInfo;
    LPRANGE lpRange;
    LPSET   lpSet;
    DWORD   Bitmask;
    DWORD   Value;
  };
  WORD      FormatStringSize;
  LPVOID    InstanceData;
} PROPERTYINFO, *LPPROPERTYINFO;

Anggota

hProperty

Atur bidang ini ke nol. Pada output, Monitor Jaringan mengembalikan handel ke properti setelah properti ditambahkan ke database properti.

Versi

Dicadangkan. Harus diatur ke nol.

Label

Nama properti.

Komentar

Deskripsi properti . Deskripsi muncul pada bilah status Monitor Jaringan.

DataType

Jenis data properti . Anggota ini bisa memiliki salah satu nilai berikut.

Nilai Makna
PROP_TYPE_VOID
 Tipe properti tidak diketahui. Tidak ada panjang atau format tersirat.
PROP_TYPE_SUMMARY
 Meringkas jenis properti. Menunjukkan instans properti pertama yang dilampirkan pengurai ke bingkai. PROP_TYPE_SUMMARY dapat berfungsi sebagai tempat penampung untuk grup properti. Nilai ini menunjukkan bahwa properti tidak didefinisikan dalam protokol RFC.
PROP_TYPE_BYTE
 Data numerik dengan ukuran satu byte (entitas 8-bit).
PROP_TYPE_WORD
 Data numerik dengan ukuran dua byte (entitas 16-bit).
PROP_TYPE_DWORD
 Data numerik dengan ukuran empat byte (entitas 32-bit).
PROP_TYPE_LARGEINT
 Data numerik dengan ukuran delapan byte (entitas 64-bit).
PROP_TYPE_ADDR
 Alamat MAC (entitas 6-byte).
PROP_TYPE_TIME
 Struktur SYSTEMTIME .
PROP_TYPE_STRING
 Data teks ASCII. Tipe data ini tidak dihentikan NULL.
Untuk data Unicode, ketika data teks ASCII ditentukan, bendera IFLAG_UNICODE juga harus diatur saat fungsi instans properti lampirkan dipanggil.
PROP_TYPE_IP_ADDRESS
 Alamat IP. (entitas 4-byte).
PROP_TYPE_IPX_ADDRESS
 Alamat IPX. (entitas 10 byte).
PROP_TYPE_BYTESWAPPED_WORD
 Kedaluwarsa. Untuk data WORD yang ditukar byte, atur DataType ke PROP_TYPE_WORD dan atur bendera IFLAG_SWAPPED saat memanggil fungsi instans properti Lampirkan .
PROP_TYPE_BYTESWAPPED_DWORD
 Kedaluwarsa. Untuk data DWORD yang ditukar byte, atur DataType ke PROP_TYPE_DWORD dan atur bendera IFLAG_SWAPPED saat memanggil fungsi instans properti Lampirkan .
PROP_TYPE_TYPED_STRING
 Kedaluwarsa. Untuk data string jenis variabel, atur DataType ke PROP_TYPE_STRING dan atur bendera IFLAG_UNICODE saat memanggil fungsi instans properti Lampirkan .
PROP_TYPE_RAW_DATA
 Data mentah dengan panjang dan format yang tidak diketahui.
PROP_TYPE_COMMENT
 Sama seperti PROP_TYPE_VOID.
PROP_TYPE_SRCFRIENDLYNAME
 Alamat nama yang ramah sumber. Monitor Jaringan tidak menyediakan dukungan pemformatan bawaan untuk tipe data ini.
PROP_TYPE_DSTFRIENDLYNAME
 Alamat nama ramah tujuan. Monitor Jaringan tidak menyediakan dukungan pemformatan bawaan untuk tipe data ini.
PROP_TYPE_TOKENRING_ADDRESS
 Alamat token-ring. Monitor Jaringan tidak menyediakan dukungan pemformatan bawaan untuk tipe data ini.
PROP_TYPE_FDDI_ADDRESS
 Alamat FDDI. Monitor Jaringan tidak menyediakan dukungan pemformatan bawaan untuk tipe data ini.
PROP_TYPE_ETHERNET_ADDRESS
 Alamat Ethernet. Monitor Jaringan tidak menyediakan dukungan pemformatan bawaan untuk tipe data ini.
PROP_TYPE_OBJECT_IDENTIFIER
 Pengidentifikasi objek SNMP yang dikodekan BER.
PROP_TYPE_VINES_IP_ADDRESS
 Alamat IP Vines (entitas 6-byte).
PROP_TYPE_VAR_LEN_SMALL_INT
 Nilai numerik tanpa panjang yang telah ditentukan sebelumnya, tetapi panjangnya tidak lebih dari 8 byte. Panjang data terlampir menentukan panjang nilai.

DataQualifier

Kualifikasi data properti. Anggota ini memberikan informasi yang tepat tentang jenis data.

DataQualifier dapat memiliki salah satu nilai berikut.

Nilai Makna
PROP_QUAL_NONE
 Jenis data properti adalah satu-satunya spesifikasi properti.
Ketika nilai ini diatur, anggota gabungan struktur diatur ke NULL, lalu diabaikan.
PROP_QUAL_RANGE
 Nilai numerik diharapkan berada dalam rentang tertentu. Tentukan rentang di anggota lpRange .
PROP_QUAL_SET
 Nilai properti dibandingkan dengan sekumpulan nilai yang ditentukan dalam anggota lpSet dari gabungan struktur. Nilai properti dapat berupa BYTE, WORD, DWORD, LARGEINT atau TIME.
PROP_QUAL_BITFIELD
 Kedaluwarsa.
PROP_QUAL_LABELED_SET
 Nilai properti dibandingkan dengan nilai dalam sekumpulan pasangan label nilai. Pasangan label nilai ditentukan dalam anggota lpSet dari gabungan struktur.
Pada waktu tampilan, jika nilai properti cocok dengan nilai dalam set, maka nilai, dan label terkait ditampilkan.
PROP_QUAL_LABELED_BITFIELD
 Kedaluwarsa. Gunakan PROP_QUAL_FLAGS sebagai gantinya.
PROP_QUAL_CONST
 Nilai properti dibandingkan dengan konstanta yang ditentukan dalam anggota Nilai dari gabungan.
Pada waktu tampilan, jika nilai properti dan konstanta tidak cocok, pesan kesalahan yang diformat muncul dengan nilai yang ditetapkan sebagai Normal.
PROP_QUAL_FLAGS
 Nilai properti dibandingkan dengan BIT tertentu yang diidentifikasi dalam anggota lpSet dari serikat.
PROP_QUAL_ARRAY
 Nilai properti menentukan array nilai. Panjang data terlampir menentukan panjang array.
Ketika nilai PROP_QUAL_ARRAY diatur, anggota gabungan struktur data PROPERTYINFO diatur ke NULL dan diabaikan.

lpExtendedInfo

Dicadangkan (anggota serikat).

lpRange

Penunjuk ke struktur RANGE yang menentukan rentang nilai. Anggota ini harus diatur jika anggota DataQualifier dari struktur ini diatur ke PROP_QUAL_RANGE (anggota serikat).

lpSet

Penunjuk ke struktur SET yang menentukan sekumpulan nilai atau label. Anggota ini harus diatur jika anggota DataQualifier struktur diatur ke PROP_QUAL_SET, PROP_QUAL_LABELED_SET, atau PROP_QUAL_FLAGS (anggota serikat).

Bitmask

Usang (anggota serikat).

Nilai

Nilai konstanta yang digunakan saat DataQualifier diatur ke PROP_QUAL_CONST (anggota union).

FormatStringSize

Ukuran maksimum yang hanya digunakan untuk deskripsi properti.

InstanceData

Tentukan fungsi format yang dipanggil untuk memformat data yang ditampilkan untuk properti . Untuk menggunakan pemformat generik, tentukan fungsi FormatPropertyInstance .

Keterangan

Struktur PROPERTYINFO digunakan dalam panggilan ke fungsi AddProperty . Fungsi AddProperty menambahkan definisi properti tunggal ke database properti parser.

Persyaratan

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

Lihat juga

AddProperty

BERBAGAI

SET

  • Last updated on