Функция обратного вызова FormatProperties

Статья
06/13/2023

Функция экспорта FormatProperties форматирует данные, отображаемые в области сведений пользовательского интерфейса сетевого монитора. Если вы хотите отобразить данные в области сведений, необходимо реализовать функцию экспорта FormatProperties во всех библиотеках DLL средства синтаксического анализа.

Синтаксис

DWORD FormatProperties(
  _In_ HFRAME         hFrame,
  _In_ LPBYTE         lpFrame,
  _In_ LPBYTE         lpProtocol,
  _In_ DWORD          nPropertyInsts,
  _In_ LPPROPERTYINST lpPropInst
);

Параметры

hFrame [in]: Дескриптор кадра, который анализируется.
lpFrame [in]: Указатель на первый байт кадра.
lpProtocol [in]: Указатель на начало данных протокола в кадре.
nPropertyInsts [in]: Количество структур PROPERTYINST , предоставляемых lpPropInst.
lpPropInst [in]: Указатель на массив структур PROPERTYINST .

Возвращаемое значение

Если функция выполнена успешно, возвращается значение TRUE.

Если функция не работает, возвращается значение FALSE.

Монитор сети вызывает функцию FormatProperties для отображения данных в области сведений пользовательского интерфейса сетевого монитора. Как правило, FormatProperties вызывается для форматирования строки сводки для протокола, а затем для форматирования всех экземпляров свойств протокола в кадре. Однако монитор сети не гарантирует количество вызовов FormatProperties для конкретного средства синтаксического анализа.

Во время реализации функции FormatProperties средство синтаксического анализа косвенно вызывает функцию FormatPropertyInstance для использования универсального модуля форматирования, предоставленного сетевым монитором, или может вызвать настраиваемую процедуру форматирования, определяемую синтаксический анализатор. Один из модулей форматирования должен вызываться для каждой структуры PROPERTYINST, передаваемой в библиотеку DLL средства синтаксического анализа в параметре lpPropInst .

Для получения сведений о	См.
Что такое средства синтаксического анализа и как они работают с монитором сети.	Средства синтаксического анализа
Какие точки входа включены в библиотеку DLL средства синтаксического анализа.	Архитектура библиотеки DLL средства синтаксического анализа
Пример реализации FormatProperties .	Реализация FormatProperties
Как универсальный модуль форматирования форматирует различные типы данных.	Выходные данные универсального модуля форматирования

Требования

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

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

FormatPropertyInstance
PROPERTYINFO
PROPERTYINST

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