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

規格需求