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]

要分析的帧的句柄。 在 AttachProperties 函数的 hFrame 参数中使用传递给分析程序 DLL 的句柄。

hProperty [in]

定义属性的 PROPERTYINFO 结构的句柄。 实现 Register 导出函数时，需指定用于定义属性的 PROPERTYINFO 结构。

长度 [in]

属性的此实例的数据长度。

lpData [in]

指向已识别数据中属性值所在的位置的指针。 使用传递到 AttachProperties 函数的 lpProtocol 参数中的分析程序 DLL 的指针。

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 为 Unicode。

返回值

如果函数成功，则返回值为 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