Estrutura PROPERTYINFO
A estrutura de dados PROPERTYINFO define uma propriedade do protocolo.
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;
-
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 .
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.
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 |
|