Estructura PROPERTYINFO

Artículo
06/13/2023

La estructura de datos PROPERTYINFO define una propiedad del protocolo.

Sintaxis

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;

Miembros

hProperty

Establezca este campo en cero. En la salida, Network Monitor devuelve un identificador a la propiedad después de agregar la propiedad a la base de datos de propiedades.

Versión

Reservado. Debe establecerse en cero.

Label

Nombre de la propiedad.

Comment

Descripción de la propiedad. La descripción aparece en la barra de estado de Network Monitor.

DataType

Tipo de datos de la propiedad . Este miembro puede tener uno de los siguientes valores.

Valor	Significado
PROP_TYPE_VOID	El tipo de propiedad es desconocido. No hay ninguna longitud ni formato implícitos.
PROP_TYPE_SUMMARY	Resumen del tipo de propiedad. Indica la primera instancia de propiedad que el analizador adjunta a un marco. PROP_TYPE_SUMMARY puede servir como marcador de posición para grupos de propiedades. Este valor indica que la propiedad no está definida en el PROTOCOLO RFC.
PROP_TYPE_BYTE	Datos numéricos con un tamaño de un byte (entidad de 8 bits).
PROP_TYPE_WORD	Datos numéricos con un tamaño de dos bytes (entidad de 16 bits).
PROP_TYPE_DWORD	Datos numéricos con un tamaño de cuatro bytes (entidad de 32 bits).
PROP_TYPE_LARGEINT	Datos numéricos con un tamaño de ocho bytes (entidad de 64 bits).
PROP_TYPE_ADDR	Dirección MAC (entidad de 6 bytes).
PROP_TYPE_TIME	Estructura SYSTEMTIME .
PROP_TYPE_STRING	Datos de texto ASCII. Este tipo de datos no está terminado en NULL. Para los datos Unicode, cuando se especifican datos de texto ASCII, también se debe establecer la marca IFLAG_UNICODE cuando se llama a la función de instancia de la propiedad attach.
PROP_TYPE_IP_ADDRESS	Dirección IP. (entidad de 4 bytes).
PROP_TYPE_IPX_ADDRESS	Dirección IPX. (entidad de 10 bytes).
PROP_TYPE_BYTESWAPPED_WORD	Obsoleto. En el caso de los datos word intercambiados por bytes, establezca DataType en PROP_TYPE_WORD y establezca la marca de IFLAG_SWAPPED al llamar a una función de instancia de la propiedad Attach .
PROP_TYPE_BYTESWAPPED_DWORD	Obsoleto. Para los datos DWORD intercambiados por bytes, establezca DataType en PROP_TYPE_DWORD y establezca la marca de IFLAG_SWAPPED al llamar a una función de instancia de la propiedad Attach .
PROP_TYPE_TYPED_STRING	Obsoleto. Para los datos de cadena de tipo variable, establezca DataType en PROP_TYPE_STRING y establezca la marca de IFLAG_UNICODE al llamar a una función de instancia de la propiedad Attach .
PROP_TYPE_RAW_DATA	Datos sin procesar de longitud y formato desconocidos.
PROP_TYPE_COMMENT	Igual que PROP_TYPE_VOID.
PROP_TYPE_SRCFRIENDLYNAME	Dirección del nombre descriptivo del origen. Network Monitor no proporciona compatibilidad de formato integrado para este tipo de datos.
PROP_TYPE_DSTFRIENDLYNAME	Dirección del nombre descriptivo de destino. Network Monitor no proporciona compatibilidad de formato integrado para este tipo de datos.
PROP_TYPE_TOKENRING_ADDRESS	Dirección del anillo de token. Network Monitor no proporciona compatibilidad de formato integrado para este tipo de datos.
PROP_TYPE_FDDI_ADDRESS	Dirección FDDI. Network Monitor no proporciona compatibilidad de formato integrado para este tipo de datos.
PROP_TYPE_ETHERNET_ADDRESS	Dirección Ethernet. Network Monitor no proporciona compatibilidad de formato integrado para este tipo de datos.
PROP_TYPE_OBJECT_IDENTIFIER	Identificador de objeto SNMP codificado en BER.
PROP_TYPE_VINES_IP_ADDRESS	Dirección IP de Vines (entidad de 6 bytes).
PROP_TYPE_VAR_LEN_SMALL_INT	Valor numérico sin una longitud determinada previamente, pero no más de 8 bytes de longitud. La longitud de los datos adjuntos determina la longitud del valor.

DataQualifier

Calificador de datos de una propiedad. Este miembro proporciona información precisa sobre el tipo de datos.

DataQualifier puede tener uno de los siguientes valores.

Valor	Significado
PROP_QUAL_NONE	El tipo de datos de propiedad es la única especificación de la propiedad. Cuando se establece este valor, el miembro de unión de la estructura se establece en NULL y, a continuación, se omite.
PROP_QUAL_RANGE	Se espera que el valor numérico esté dentro de un intervalo determinado. Defina el intervalo en el miembro lpRange .
PROP_QUAL_SET	El valor de una propiedad se compara con un conjunto de valores que se especifican en el miembro lpSet de la unión de la estructura. El valor de una propiedad puede ser BYTE, WORD, DWORD, LARGEINT o TIME.
PROP_QUAL_BITFIELD	Obsoleto.
PROP_QUAL_LABELED_SET	El valor de una propiedad se compara con un valor en un conjunto de pares de etiqueta de valor. Los pares de etiqueta de valor se especifican en el miembro lpSet de la unión de la estructura. En tiempo de presentación, si el valor de la propiedad coincide con un valor en el conjunto, se muestran tanto un valor como la etiqueta asociada.
PROP_QUAL_LABELED_BITFIELD	Obsoleto. Use PROP_QUAL_FLAGS en su lugar.
PROP_QUAL_CONST	El valor de una propiedad se compara con una constante especificada en el miembro Value de la unión. En tiempo de presentación, si los valores de propiedad y la constante no coinciden, aparece un mensaje de error con formato con el valor establecido como Normal.
PROP_QUAL_FLAGS	El valor de la propiedad se compara con los TBI específicos identificados en el miembro lpSet de la unión.
PROP_QUAL_ARRAY	El valor de una propiedad especifica una matriz de valores. La longitud de los datos adjuntos determina la longitud de una matriz. Cuando se establece el valor de PROP_QUAL_ARRAY, el miembro de unión de la estructura de datos PROPERTYINFO se establece en NULL y se omite.

lpExtendedInfo

Reservado (miembro de unión).

lpRange

Puntero a una estructura RANGE que define un intervalo de valores. Este miembro debe establecerse si el miembro DataQualifier de esta estructura está establecido en PROP_QUAL_RANGE (miembro de unión).

lpSet

Puntero a una estructura SET que especifica un conjunto de valores o etiquetas. Este miembro debe establecerse si el miembro DataQualifier de la estructura está establecido en PROP_QUAL_SET, PROP_QUAL_LABELED_SET o PROP_QUAL_FLAGS (miembro de unión).

Máscara

Obsoleto (miembro de unión).

Valor

Valor constante utilizado cuando DataQualifier se establece en PROP_QUAL_CONST (miembro de unión).

FormatStringSize

Tamaño máximo utilizado solo para la descripción de la propiedad.

InstanceData

Especifique la función de formato a la que se llama para dar formato a los datos mostrados para la propiedad . Para usar el formateador genérico, especifique la función FormatPropertyInstance .

Observaciones

La estructura PROPERTYINFO se usa en llamadas a la función AddProperty . La función AddProperty agrega una única definición de propiedad a la base de datos de propiedades del analizador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h

Vea también

AddProperty
GAMA
SET

Compartir a través de