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]
-
正在分析的帧的句柄。 在 AttachProperties 函数的 hFrame 参数中使用传递给分析程序 DLL 的句柄。
-
hProperty [in]
-
定义属性的 PROPERTYINFO 结构的句柄。 实现 Register 导出函数时，请指定定义属性的 PROPERTYINFO 结构。
-
Length [in]
-
属性的此实例的数据长度。
-
lpData [in]
-
指向已识别数据中属性值所在的位置的指针。 在 AttachProperties 函数的 lpProtocol 参数中使用传递给分析程序 DLL 的指针。
-
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 为 Unicode。
返回值
如果函数成功，则返回值为 TRUE。
如果该函数不成功，则返回值为 FALSE。
备注
AttachPropertyInstance 函数是在 AttachProperties 导出函数实现期间调用的。 将属性附加到数据时，网络监视器将创建 一个 PROPERTYINST 结构，该结构定义附加属性的实例。
在 AttachProperties 实现期间，调用 AttachPropertyInstance 以使用捕获中存在的数据。 还可以调用 AttachPropertyInstanceEx 函数来修改属性数据。 但是，建议使用捕获中存在的数据。
| 有关的信息，请参阅 | 请参阅 |
|---|---|
| 什么是分析程序，以及它们如何与网络监视器配合使用。 | 分析器 |
| 如何调用 AttachPropertyInstance。 | 实现 AttachProperties |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|