Struttura PROPERTYINFO

Articolo
06/13/2023

La struttura dei dati PROPERTYINFO definisce una proprietà del protocollo.

Sintassi

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;

Members

hProperty

Impostare questo campo su zero. In caso di output, Monitoraggio di rete restituisce un handle alla proprietà dopo l'aggiunta della proprietà al database delle proprietà.

Versione

Riservato. Deve essere impostato su zero.

Etichetta

Nome della proprietà.

Commento

Descrizione della proprietà. La descrizione viene visualizzata sulla barra di stato di Monitoraggio di rete.

DataType

Tipo di dati della proprietà. Questo membro può avere uno dei valori seguenti.

Valore	Significato
PROP_TYPE_VOID	Il tipo di proprietà è sconosciuto. Non esiste una lunghezza o un formato implicito.
PROP_TYPE_SUMMARY	Riepilogo del tipo di proprietà. Indica la prima istanza della proprietà associata al parser a un frame. PROP_TYPE_SUMMARY può fungere da segnaposto per i gruppi di proprietà. Questo valore indica che la proprietà non è definita nel protocollo RFC.
PROP_TYPE_BYTE	Dati numerici con una dimensione di un byte (entità a 8 bit).
PROP_TYPE_WORD	Dati numerici con dimensioni pari a due byte (entità a 16 bit).
PROP_TYPE_DWORD	Dati numerici con dimensioni di quattro byte (entità a 32 bit).
PROP_TYPE_LARGEINT	Dati numerici con dimensioni pari a otto byte (entità a 64 bit).
PROP_TYPE_ADDR	Indirizzo MAC (entità a 6 byte).
PROP_TYPE_TIME	Struttura SYSTEMTIME .
PROP_TYPE_STRING	Dati di testo ASCII. Questo tipo di dati non è con terminazione NULL. Per i dati Unicode, quando si specificano dati di testo ASCII, il flag IFLAG_UNICODE deve essere impostato anche quando viene chiamata la funzione di istanza della proprietà attach.
PROP_TYPE_IP_ADDRESS	IP Address (Indirizzo IP). (entità a 4 byte).
PROP_TYPE_IPX_ADDRESS	Indirizzo IPX. (entità a 10 byte).
PROP_TYPE_BYTESWAPPED_WORD	Obsoleta. Per i dati WORD con scambio di byte, impostare DataType su PROP_TYPE_WORD e impostare il flag IFLAG_SWAPPED quando si chiama una funzione di istanza della proprietà Attach .
PROP_TYPE_BYTESWAPPED_DWORD	Obsoleta. Per i dati DWORD scambiati da byte, impostare DataType su PROP_TYPE_DWORD e impostare il flag IFLAG_SWAPPED quando si chiama una funzione di istanza della proprietà Attach .
PROP_TYPE_TYPED_STRING	Obsoleta. Per i dati stringa di tipo variabile, impostare DataType su PROP_TYPE_STRING e impostare il flag IFLAG_UNICODE quando si chiama una funzione di istanza della proprietà Attach .
PROP_TYPE_RAW_DATA	Dati non elaborati di lunghezza e formato sconosciuti.
PROP_TYPE_COMMENT	Uguale a PROP_TYPE_VOID.
PROP_TYPE_SRCFRIENDLYNAME	Indirizzo del nome descrittivo dell'origine. Monitoraggio di rete non fornisce il supporto di formattazione predefinito per questo tipo di dati.
PROP_TYPE_DSTFRIENDLYNAME	Indirizzo del nome descrittivo della destinazione. Monitoraggio di rete non fornisce il supporto di formattazione predefinito per questo tipo di dati.
PROP_TYPE_TOKENRING_ADDRESS	Indirizzo dell'anello del token. Monitoraggio di rete non fornisce il supporto di formattazione predefinito per questo tipo di dati.
PROP_TYPE_FDDI_ADDRESS	Indirizzo FDDI. Monitoraggio di rete non fornisce il supporto di formattazione predefinito per questo tipo di dati.
PROP_TYPE_ETHERNET_ADDRESS	Indirizzo Ethernet. Monitoraggio di rete non fornisce il supporto di formattazione predefinito per questo tipo di dati.
PROP_TYPE_OBJECT_IDENTIFIER	Identificatore di oggetto SNMP con codifica BER.
PROP_TYPE_VINES_IP_ADDRESS	Indirizzo IP delle viti (entità a 6 byte).
PROP_TYPE_VAR_LEN_SMALL_INT	Valore numerico senza lunghezza predeterminato, ma non più di 8 byte di lunghezza. La lunghezza dei dati associati determina la lunghezza del valore.

DataQualifier

Qualificatore di dati di una proprietà. Questo membro fornisce informazioni precise sul tipo di dati.

DataQualifier può avere uno dei valori seguenti.

Valore	Significato
PROP_QUAL_NONE	Il tipo di dati della proprietà è l'unica specifica della proprietà . Quando questo valore viene impostato, il membro di unione della struttura viene impostato su NULL e quindi ignorato.
PROP_QUAL_RANGE	Si prevede che il valore numerico sia compreso in un determinato intervallo. Definire l'intervallo nel membro lpRange .
PROP_QUAL_SET	Il valore di una proprietà viene confrontato con un set di valori specificati nel membro lpSet dell'unione della struttura. Il valore di una proprietà può essere BYTE, WORD, DWORD, LARGEINT o TIME.
PROP_QUAL_BITFIELD	Obsoleta.
PROP_QUAL_LABELED_SET	Il valore di una proprietà viene confrontato con un valore in un set di coppie di etichette valore. Le coppie di etichette valore vengono specificate nel membro lpSet dell'unione della struttura. In fase di visualizzazione, se il valore della proprietà corrisponde a un valore nel set, vengono visualizzati sia un valore che l'etichetta associata.
PROP_QUAL_LABELED_BITFIELD	Obsoleta. Usare invece PROP_QUAL_FLAGS.
PROP_QUAL_CONST	Il valore di una proprietà viene confrontato con una costante specificata nel membro Value dell'unione. In fase di visualizzazione, se i valori delle proprietà e la costante non corrispondono, viene visualizzato un messaggio di errore formattato con il valore impostato su Normal.
PROP_QUAL_FLAGS	Il valore della proprietà viene confrontato con biT specifici identificati nel membro lpSet dell'unione.
PROP_QUAL_ARRAY	Il valore di una proprietà specifica una matrice di valori. La lunghezza dei dati collegati determina la lunghezza di una matrice. Quando viene impostato il valore PROP_QUAL_ARRAY, il membro di unione della struttura di dati PROPERTYINFO viene impostato su NULL e ignorato.

lpExtendedInfo

Riservato (membro dell'unione).

lpRange

Puntatore a una struttura RANGE che definisce un intervallo di valori. Questo membro deve essere impostato se il membro DataQualifier di questa struttura è impostato su PROP_QUAL_RANGE (membro dell'unione).

lpSet

Puntatore a una struttura SET che specifica un set di valori o etichette. Questo membro deve essere impostato se il membro DataQualifier della struttura è impostato su PROP_QUAL_SET, PROP_QUAL_LABELED_SET o PROP_QUAL_FLAGS (membro dell'unione).

Maschera

Obsoleto (membro dell'unione).

Valore

Valore costante utilizzato quando DataQualifier è impostato su PROP_QUAL_CONST (membro dell'unione).

FormatStringSize

Dimensione massima utilizzata solo per la descrizione della proprietà.

Instancedata

Specificare la funzione di formato chiamata per formattare i dati visualizzati per la proprietà . Per usare il formattatore generico, specificare la funzione FormatPropertyInstance .

Commenti

La struttura PROPERTYINFO viene utilizzata nelle chiamate alla funzione AddProperty . La funzione AddProperty aggiunge una singola definizione di proprietà al database delle proprietà del parser.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h

Vedi anche

AddProperty
GAMMA
SET