Estrutura PROPERTYINFO

A estrutura de dados PROPERTYINFO define uma propriedade do protocolo.

Sintaxe

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;

Membros

hProperty

Defina esse campo como zero. Na saída, o Monitor de Rede retorna um identificador para a propriedade depois que a propriedade é adicionada ao banco de dados de propriedades.

Versão

Reservado. Deve ser definido como zero.

Rótulo

Nome da propriedade.

Comentário

Descrição da propriedade. A descrição aparece na barra de status do Monitor de Rede.

DataType

Tipo de dados da propriedade . Esse membro pode ter um dos valores a seguir.

Valor Significado
PROP_TYPE_VOID
O tipo de propriedade é desconhecido. Não há nenhum tamanho ou formato implícito.
PROP_TYPE_SUMMARY
Resumindo o tipo de propriedade. Indica a primeira instância de propriedade que o analisador anexa a um quadro. PROP_TYPE_SUMMARY pode servir como um espaço reservado para grupos de propriedades. Esse valor indica que a propriedade não está definida no protocolo RFC.
PROP_TYPE_BYTE
Dados numéricos com um tamanho de um byte (entidade de 8 bits).
PROP_TYPE_WORD
Dados numéricos com um tamanho de dois bytes (entidade de 16 bits).
PROP_TYPE_DWORD
Dados numéricos com um tamanho de quatro bytes (entidade de 32 bits).
PROP_TYPE_LARGEINT
Dados numéricos com um tamanho de oito bytes (entidade de 64 bits).
PROP_TYPE_ADDR
Endereço MAC (entidade de 6 bytes).
PROP_TYPE_TIME
Estrutura SYSTEMTIME .
PROP_TYPE_STRING
Dados de texto ASCII. Esse tipo de dados não é encerrado em NULL.
Para dados Unicode, quando os dados de texto ASCII são especificados, o sinalizador IFLAG_UNICODE também deve ser definido quando a função de instância de propriedade de anexação é chamada.
PROP_TYPE_IP_ADDRESS
Endereço IP. (Entidade de 4 bytes).
PROP_TYPE_IPX_ADDRESS
Endereço IPX. (Entidade de 10 bytes).
PROP_TYPE_BYTESWAPPED_WORD
Obsoleto. Para dados word trocados por bytes, defina DataType como PROP_TYPE_WORD e defina o sinalizador IFLAG_SWAPPED ao chamar uma função de instância de propriedade Attach .
PROP_TYPE_BYTESWAPPED_DWORD
Obsoleto. Para dados DWORD trocados por bytes, defina DataType como PROP_TYPE_DWORD e defina o sinalizador IFLAG_SWAPPED ao chamar uma função de instância de propriedade Attach .
PROP_TYPE_TYPED_STRING
Obsoleto. Para dados de cadeia de caracteres de tipo variável, defina DataType como PROP_TYPE_STRING e defina o sinalizador IFLAG_UNICODE ao chamar uma função de instância de propriedade Attach .
PROP_TYPE_RAW_DATA
Dados brutos de tamanho e formato desconhecidos.
PROP_TYPE_COMMENT
O mesmo que PROP_TYPE_VOID.
PROP_TYPE_SRCFRIENDLYNAME
Endereço de nome amigável à origem. O Monitor de Rede não fornece suporte à formatação interna para esse tipo de dados.
PROP_TYPE_DSTFRIENDLYNAME
Endereço do nome amigável de destino. O Monitor de Rede não fornece suporte à formatação interna para esse tipo de dados.
PROP_TYPE_TOKENRING_ADDRESS
Endereço do anel de token. O Monitor de Rede não fornece suporte à formatação interna para esse tipo de dados.
PROP_TYPE_FDDI_ADDRESS
Endereço FDDI. O Monitor de Rede não fornece suporte à formatação interna para esse tipo de dados.
PROP_TYPE_ETHERNET_ADDRESS
Endereço Ethernet. O Monitor de Rede não fornece suporte à formatação interna para esse tipo de dados.
PROP_TYPE_OBJECT_IDENTIFIER
Identificador de objeto SNMP codificado em BER.
PROP_TYPE_VINES_IP_ADDRESS
Endereço IP do Vines (entidade de 6 bytes).
PROP_TYPE_VAR_LEN_SMALL_INT
Valor numérico sem um comprimento predeterminado, mas não mais do que 8 bytes de comprimento. O comprimento dos dados anexados determina o comprimento do valor.

DataQualifier

O qualificador de dados de uma propriedade. Esse membro fornece informações precisas sobre o tipo de dados.

O DataQualifier pode ter um dos valores a seguir.

Valor Significado
PROP_QUAL_NONE
O tipo de dados de propriedade é a única especificação da propriedade .
Quando esse valor é definido, o membro da união da estrutura é definido como NULL e ignorado.
PROP_QUAL_RANGE
Espera-se que o valor numérico esteja dentro de um determinado intervalo. Defina o intervalo no membro lpRange .
PROP_QUAL_SET
O valor de uma propriedade é comparado a um conjunto de valores especificados no membro lpSet da união da estrutura. O valor de uma propriedade pode ser BYTE, WORD, DWORD, LARGEINT ou TIME.
PROP_QUAL_BITFIELD
Obsoleto.
PROP_QUAL_LABELED_SET
O valor de uma propriedade é comparado a um valor em um conjunto de pares de rótulos de valor. Os pares de rótulo de valor são especificados no membro lpSet da união da estrutura.
Em tempo de exibição, se o valor da propriedade corresponder a um valor no conjunto, um valor e o rótulo associado serão exibidos.
PROP_QUAL_LABELED_BITFIELD
Obsoleto. Em vez disso, use PROP_QUAL_FLAGS.
PROP_QUAL_CONST
O valor de uma propriedade é comparado a uma constante especificada no membro Value da união.
Em tempo de exibição, se os valores de propriedade e a constante não corresponderem, uma mensagem de erro formatada aparecerá com o valor definido como Normal.
PROP_QUAL_FLAGS
O valor da propriedade é comparado a BITs específicos identificados no membro lpSet da união.
PROP_QUAL_ARRAY
O valor de uma propriedade especifica uma matriz de valores. O comprimento dos dados anexados determina o comprimento de uma matriz.
Quando o valor PROP_QUAL_ARRAY é definido, o membro da união da estrutura de dados PROPERTYINFO é definido como NULL e ignorado.

lpExtendedInfo

Reservado (membro do sindicato).

lpRange

Ponteiro para uma estrutura RANGE que define um intervalo de valores. Esse membro deverá ser definido se o membro DataQualifier dessa estrutura estiver definido como PROP_QUAL_RANGE (membro da união).

lpSet

Ponteiro para uma estrutura SET que especifica um conjunto de valores ou rótulos. Esse membro deverá ser definido se o membro DataQualifier da estrutura estiver definido como PROP_QUAL_SET, PROP_QUAL_LABELED_SET ou PROP_QUAL_FLAGS (membro da união).

Bitmask

Obsoleto (membro da união).

Valor

Valor constante usado quando o DataQualifier é definido como PROP_QUAL_CONST (membro da união).

FormatStringSize

Tamanho máximo usado apenas para a descrição da propriedade.

Instancedata

Especifique a função de formato que é chamada para formatar os dados exibidos para a propriedade . Para usar o formatador genérico, especifique a função FormatPropertyInstance .

Comentários

A estrutura PROPERTYINFO é usada em chamadas para a função AddProperty . A função AddProperty adiciona uma única definição de propriedade ao banco de dados de propriedade do analisador.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Netmon.h

Confira também

AddProperty

GAMA

SET