Функция AttachPropertyInstance
Функция AttachPropertyInstance сопоставляет существующее свойство с определенным расположением в распознаваемых данных.
Синтаксис
BOOL WINAPI AttachPropertyInstance(
_In_ HFRAME hFrame,
_In_ HPROPERTY hProperty,
_In_ DWORD Length,
_In_ ULPVOID lpData,
_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 .
-
HelpID [in]
-
Идентификатор (от 0 до 2047), используемый для задания контекстно-зависимой справки для свойства .
Номер идентификатора относится к файлу справки, связанному с базой данных свойств протокола.
-
IndentLevel [in]
-
Уровень отступа (от 0 до 15), используемый для иерархического отображения свойства.
Монитор сети использует уровни от 0 до 14 для отступов. Уровень 15 — это специальное значение, позволяющее синтаксическому анализатору прикрепить невидимое скрытое свойство.
-
IFlags [in]
-
Значение поля BIT, указывающее порядок bit в свойстве . Предыдущие средства синтаксического анализа, которые устанавливали для fError значение 0 или 1, теперь должны задать для fError значение IFLAG_ERROR. Задайте для этого параметра одно из следующих значений.
Значение Значение - IFLAG_ERROR
Данные в кадре имеют ошибку. - IFLAG_SWAPPED
Во время присоединения байт WORD является форматом, не являющимся intel. - IFLAG_UNICODE
Во время присоединения string имеет значение Юникод.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается неудачно, возвращается значение FALSE.
Комментарии
Функция AttachPropertyInstance вызывается во время реализации функции экспорта AttachProperties . При присоединении свойства к данным сетевой монитор создает структуру PROPERTYINST , которая определяет экземпляр присоединенного свойства.
Во время реализации AttachProperties вызовите AttachPropertyInstance , чтобы использовать данные, которые существуют в записи. Вы также можете вызвать функцию AttachPropertyInstanceEx , чтобы изменить данные свойства. Тем не менее рекомендуется использовать данные, как они существуют в записи.
| Для получения сведений о | См. |
|---|---|
| Что такое средства синтаксического анализа и как они работают с сетевым монитором. | Средства синтаксического анализа |
| Как вызвать AttachPropertyInstance. | Реализация attachProperties |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|