Struttura PROPERTYINFO

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.

Label

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
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 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