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

Функция AttachPropertyInstanceEx

  • Статья

Функция AttachPropertyInstanceEx сопоставляет существующее свойство с определенным расположением в распознаваемых данных и изменяет значение данных свойства.

Синтаксис

BOOL WINAPI AttachPropertyInstanceEx(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     LengthEx,
  _In_ ULPVOID   lpDataEx,
  _In_ DWORD     HelpID,
  _In_ DWORD     IndentLevel,
  _In_ DWORD     IFlags
);

Параметры

hFrame [in]

Дескриптор кадра, который анализируется. Используйте дескриптор, переданный в библиотеку DLL средства синтаксического анализа в параметре hFrame функции AttachProperties .

hProperty [in]

Обработка структуры PROPERTYINFO , определяющей свойство . При реализации функции экспорта Register укажите структуру PROPERTYINFO , которая определяет свойство .

Длина [in]

Длина данных для данного экземпляра свойства.

lpData [in]

Указатель на расположение в распознаваемых данных, где находится значение свойства. Используйте указатель, переданный в библиотеку DLL средства синтаксического анализа в параметре lpProtocol функции AttachProperties .

LengthEx [in]

Длина расширенной длины данных в байтах.

lpDataEx [in]

Указатель на расширенные данные, которые обычно являются переменной стека, содержащей данные расширения.

HelpID [in]

Идентификатор (от 0 до 2047), используемый для задания контекстно-зависимой справки для свойства.

Номер HelpID относится к файлу справки, связанному с базой данных свойств протокола.

IndentLevel [in]

Уровень отступа (от 0 до 15), используемый для иерархического отображения свойства.

Монитор сети использует уровни от 0 до 9. Уровень 15 — это специальное значение, которое позволяет синтаксическому анализатору прикрепить скрытое свойство, которое невидимо.

IFlags [in]

Значение поля BIT, указывающее порядок bit в свойстве . Предыдущие средства синтаксического анализа, которые устанавливали fError в значение 0 или 1, теперь должны устанавливать для fError значение IFLAG_ERROR. Задайте для этого параметра одно из следующих значений.

Значение Значение
IFLAG_ERROR
 Данные в кадре имеют ошибку.
IFLAG_SWAPPED
 Во время вложения байт WORD является форматом, не являющимся intel.
IFLAG_UNICODE
 Во время присоединения string имеет значение Юникод.

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

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

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

Комментарии

Функция AttachPropertyInstanceEx вызывается во время реализации функции экспорта AttachProperties . При присоединении свойства к данным с помощью AttachPropertyInstanceEx сетевой монитор создает структуру PROPERTYINST , которая определяет экземпляр присоединенного свойства, и структуру PROPERTYINSTEX , которая определяет расширенные данные.

Если вызывается AttachPropertyInstanceEx и расширенные данные не предоставляются, параметр lpDataEx имеет значение NULL или параметр LengthEx равен 0, то вызов AttachPropertyInstanceEx функционально эквивалентен вызову AttachPropertyInstance .

Во время реализации AttachProperties вызовите AttachPropertyInstance , чтобы использовать данные в том виде, в который они существуют в записи. Вы также можете вызвать функцию AttachPropertyInstanceEx для изменения данных свойства. Однако рекомендуется использовать данные в том виде, в который они существуют в записи.

Требования

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