AttachProperties 回呼函式

AttachProperties匯出函式會將屬性對應至已辨識資料片段內的位置。 必須針對剖析器 DLL 支援的每個剖析器實作AttachProperties。

語法

DWORD AttachProperties(
  _In_ HFRAME    hFrame,
  _In_ LPBYTE    lpFrame,
  _In_ LPBYTE    lpProtocol,
  _In_ DWORD     MacType,
  _In_ DWORD     BytesLeft,
  _In_ HPROTOCOL hPreviousProtocol,
  _In_ DWORD     nPreviousProtocolOffset,
  _In_ DWORD     lpInstData
);

參數

hFrame [in]

正在剖析之框架的控制碼。

lpFrame [in]

框架中第一個位元組的指標。

lpProtocol [in]

已辨識資料開頭的指標。

MacType [in]

框架中第一個通訊協定的 MAC 值。 MacType可以是下列其中一項：

值	意義
MAC_TYPE_ETHERNET	802.3
MAC_TYPE_TOKENRING	802.5
MAC_TYPE_FDDI	ANSI X3T9.5

BytesLeft [in]

從辨識資料開頭開始的框架中剩餘的位元組數。

hPreviousProtocol [in]

先前通訊協定的控制碼。

nPreviousProtocolOffset [in]

從畫面開頭開始的上一個通訊協定位移。

lpInstData [in]

前一個通訊協定提供的實例資料的指標。 實例資料長度不能超過DWORD_PTR。

傳回值

如果函式成功，則傳回值是框架中辨識資料之後的第一個位元組指標，如果辨識的資料是框架中最後一個資料片段，則為 Null 。

如果函式不成功，則傳回值是已辨識資料的指標。 lpProtocol參數會將指標傳遞至剖析器 DLL。

備註

網路監視器會針對每個辨識框架中資料片段的剖析器呼叫 AttachProperties 函式。 請注意，剖析器會決定哪些屬性存在於已辨識的資料中，以及每個屬性所在的位置。

在 AttachProperties的實作期間，呼叫 AttachPropertyInstance 以使用資料，因為它存在於擷取中。 您也可以呼叫 AttachPropertyInstanceEx 函式來修改屬性資料。 不過，建議您使用資料，因為它存在於擷取中。

AttachPropertyInstanceEx和AttachPropertyInstance函式只會針對存在於已辨識資料中的屬性呼叫。 請注意，網路監視器具有剖析器 的屬性資料庫 ，其中包含剖析器所支援之所有屬性的描述。

執行個體資料

實例資料是從一個剖析器傳遞至另一個剖析器的資訊。 實例資料可以是長度小於或等於DWORD_PTR的任何資料，或資料指標，例如原始框架資料，不需要由剖析器配置或釋放。 在AttachProperties和RecognizeFrame函式的lpInstData參數中，網路監視器會提供上一個通訊協定實例資料的指標。 您可以在 RecognizeFrame實作期間設定剖析器的實例資料。

規格需求

另請參閱

AttachPropertyInstance

AttachPropertyInstanceEx

RecognizeFrame