Поделиться через

Структура PROPERTYINFO

  • Статья

Структура данных PROPERTYINFO определяет одно свойство протокола.

Синтаксис

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

Задайте для этого поля нулевое значение. На выходе монитор сети возвращает дескриптор свойства после добавления свойства в базу данных свойств.

Версия

Зарезервировано. Необходимо задать нулевое значение.

Label

Имя свойства.

Комментарий

Описание свойства. Описание отображается в строке состояния монитора сети.

DataType

Тип данных свойства. Этот элемент может иметь одно из следующих значений.

Значение Значение
PROP_TYPE_VOID
 Тип свойства неизвестен. Не подразумевается длина или формат.
PROP_TYPE_SUMMARY
 Суммирование типа свойства. Указывает первый экземпляр свойства, который средство синтаксического анализа присоединяет к кадру. PROP_TYPE_SUMMARY может служить заполнителем для групп свойств. Это значение указывает, что свойство не определено в протоколе RFC.
PROP_TYPE_BYTE
 Числовые данные размером в один байт (8-разрядная сущность).
PROP_TYPE_WORD
 Числовые данные размером в два байта (16-разрядная сущность).
PROP_TYPE_DWORD
 Числовые данные размером в четыре байта (32-разрядная сущность).
PROP_TYPE_LARGEINT
 Числовые данные размером 8 байт (64-разрядная сущность).
PROP_TYPE_ADDR
 MAC-адрес (6-байтовая сущность).
PROP_TYPE_TIME
 Структура SYSTEMTIME.
PROP_TYPE_STRING
 Текстовые данные ASCII. Этот тип данных не заканчивается значением NULL.
Для данных Юникода при указании текстовых данных ASCII также должен быть установлен флаг IFLAG_UNICODE при вызове функции экземпляра свойства attach.
PROP_TYPE_IP_ADDRESS
 IP-адрес. (4-байтовая сущность).
PROP_TYPE_IPX_ADDRESS
 IPX-адрес. (10-байтовая сущность).
PROP_TYPE_BYTESWAPPED_WORD
 Является устаревшей. Для переключения данных WORD в байтах задайте для параметра DataType значение PROP_TYPE_WORD и установите флаг IFLAG_SWAPPED при вызове функции экземпляра свойства Attach .
PROP_TYPE_BYTESWAPPED_DWORD
 Является устаревшей. Для переключения данных DWORD в байтах задайте для DataType значение PROP_TYPE_DWORD и установите флаг IFLAG_SWAPPED при вызове функции экземпляра свойства Attach .
PROP_TYPE_TYPED_STRING
 Является устаревшей. Для строковых данных переменного типа задайте для параметра DataType значение PROP_TYPE_STRING и установите флаг IFLAG_UNICODE при вызове функции экземпляра свойства Attach .
PROP_TYPE_RAW_DATA
 Необработанные данные неизвестной длины и формата.
PROP_TYPE_COMMENT
 То же, что и PROP_TYPE_VOID.
PROP_TYPE_SRCFRIENDLYNAME
 Адрес понятного для источника имени. Монитор сети не предоставляет встроенную поддержку форматирования для этого типа данных.
PROP_TYPE_DSTFRIENDLYNAME
 Адрес понятного имени назначения. Монитор сети не предоставляет встроенную поддержку форматирования для этого типа данных.
PROP_TYPE_TOKENRING_ADDRESS
 Адрес круга маркеров. Монитор сети не предоставляет встроенную поддержку форматирования для этого типа данных.
PROP_TYPE_FDDI_ADDRESS
 Адрес FDDI. Монитор сети не предоставляет встроенную поддержку форматирования для этого типа данных.
PROP_TYPE_ETHERNET_ADDRESS
 Адрес Ethernet. Монитор сети не предоставляет встроенную поддержку форматирования для этого типа данных.
PROP_TYPE_OBJECT_IDENTIFIER
 Идентификатор snmp-объекта в кодировке BER.
PROP_TYPE_VINES_IP_ADDRESS
 IP-адрес Vines (6-байтовая сущность).
PROP_TYPE_VAR_LEN_SMALL_INT
 Числовое значение без предварительно определенной длины, но не более 8 байт. Длина вложенных данных определяет длину значения.

DataQualifier

Квалификатор данных свойства. Этот элемент предоставляет точные сведения о типе данных.

DataQualifier может иметь одно из следующих значений.

Значение Значение
PROP_QUAL_NONE
 Тип данных свойства является единственной спецификацией свойства.
Если задано это значение, член объединения структуры имеет значение NULL, а затем игнорируется.
PROP_QUAL_RANGE
 Ожидается, что числовое значение будет находиться в заданном диапазоне. Определите диапазон в элементе lpRange .
PROP_QUAL_SET
 Значение свойства сравнивается с набором значений, указанных в элементе lpSet объединения структуры. Значение свойства может быть BYTE, WORD, DWORD, LARGEINT или TIME.
PROP_QUAL_BITFIELD
 Является устаревшей.
PROP_QUAL_LABELED_SET
 Значение свойства сравнивается со значением в наборе пар меток значения. Пары меток значения указываются в элементе lpSet объединения структуры.
Если во время отображения значение свойства совпадает со значением в наборе, отображаются как значение, так и связанная метка.
PROP_QUAL_LABELED_BITFIELD
 Является устаревшей. Вместо этого используйте PROP_QUAL_FLAGS.
PROP_QUAL_CONST
 Значение свойства сравнивается с константой, указанной в элементе Value объединения.
Если во время отображения значения свойств и константы не совпадают, отображается форматируемое сообщение об ошибке со значением , заданным как Обычный.
PROP_QUAL_FLAGS
 Значение свойства сравнивается с определенными bit, указанными в элементе lpSet объединения.
PROP_QUAL_ARRAY
 Значение свойства задает массив значений. Длина присоединенных данных определяет длину массива.
Если задано значение PROP_QUAL_ARRAY, член объединения структуры данных PROPERTYINFO имеет значение NULL и игнорируется.

lpExtendedInfo

Зарезервировано (член объединения).

lpRange

Указатель на структуру RANGE , которая определяет диапазон значений. Этот элемент должен быть задан, если элемент DataQualifier этой структуры имеет значение PROP_QUAL_RANGE (член объединения).

lpSet

Указатель на структуру SET , задающую набор значений или меток. Этот элемент должен быть задан, если элемент DataQualifier структуры имеет значение PROP_QUAL_SET, PROP_QUAL_LABELED_SET или PROP_QUAL_FLAGS (член объединения).

Битовой маски

Устаревшее (член объединения).

Значение

Значение константы, используемое, когда DataQualifier имеет значение PROP_QUAL_CONST (член объединения).

FormatStringSize

Максимальный размер, используемый только для описания свойства.

InstanceData

Укажите функцию форматирования, вызываемую для форматирования отображаемых данных для свойства . Чтобы использовать универсальный модуль форматирования, укажите функцию FormatPropertyInstance .

Комментарии

Структура PROPERTYINFO используется в вызовах функции AddProperty . Функция AddProperty добавляет одно определение свойства в базу данных свойств средства синтаксического анализа.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Netmon.h

См. также раздел

AddProperty

ДИАПАЗОН

SET