通过

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]

正在分析的帧的句柄。 在 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 [仅限桌面应用]
标头
Netmon.h
库
Nmapi.lib
DLL
Nmapi.dll

另请参阅

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST