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 結構。

長度 [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 函式來修改屬性資料。 不過，建議您使用資料，因為它存在於擷取中。

規格需求

另請參閱

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST