AttachProperties

The AttachProperties export function maps the properties to a location within a piece of recognized data. AttachProperties must be implemented for each parser that the parser DLL supports.

DWORDAttachProperties(HFRAMEhFrame,
LPBYTElpFrame,
LPBYTElpProtocol,
DWORDMacType,
DWORDBytesLeft,
HPROTOCOLhPreviousProtocol,
DWORDnPreviousProtocolOffset,
DWORDlpInstData);

Parameters

• hFrame
  [in] Handle of the frame that is being parsed.

• lpFrame
  [in] Pointer to the first byte in a frame.

• lpProtocol
  [in] Pointer to the start of the recognized data.

• MacType
  [in] MAC value of the first protocol in a frame. The MacType can be one of the following:

  Value	Meaning
  MAC_TYPE_ETHERNET	802.3
  MAC_TYPE_TOKENRING	802.5
  MAC_TYPE_FDDI	ANSI X3T9.5

• BytesLeft
  [in] The remaining number of bytes in a frame — starting at the beginning of the recognized data.

• hPreviousProtocol
  [in] Handle of the previous protocol.

• nPreviousProtocolOffset
  [in] Offset of the previous protocol — starting at the beginning of the frame.

• lpInstData
  [in] Pointer to the instance data that the previous protocol provides. Instance data cannot be longer than a DWORD_PTR in length.

Return Values

If the function is successful, the return value is a pointer to the first byte after the recognized data in a frame or NULL if the recognized data is the last piece of data in a frame.

If the function is unsuccessful, the return value is a pointer to the recognized data. The lpProtocol parameter passes the pointer to the parser DLL.

Remarks

Network Monitor calls the AttachProperties function for each parser that recognizes a piece of data in a frame. Note that the parser determines which properties exist in the recognized data, and where each property is located.

During the implementation of AttachProperties, call AttachPropertyInstance to use the data as it exists in the capture. You can also call AttachPropertyInstanceEx function to modify the property data. However, it is advised that you use the data as it exists in the capture.

The AttachPropertyInstanceEx and AttachPropertyInstance functions are called only for the properties that exist in the recognized data. Note that Network Monitor has a property database for the parser that contains a description of all the properties that the parser supports.

Instance data

Instance data is information that is passed from one parser to another. Instance data can be any data that is less than or equal to a DWORD_PTR in length, or a pointer to data, such as raw frame data, that does not need to be allocated by or freed by the parser. In the lpInstData parameter of the AttachProperties and RecognizeFrame functions, Network Monitor provides a pointer to the instance data of the previous protocol. You can set the instance data for your parser during your implementation of RecognizeFrame.

For information on	See
What parsers are, and how they work with Network Monitor.	Parsers
What entry points are included in the parser DLL.	Parser DLL Architecture
How to recognize data.	Implementing RecognizeFrame
How to create a property database.	Implementing Register
How to implement AttachProperties— includes an example.	Implementing AttachProperties

Requirements

Client	Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server	Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Header	Declared in Netmon.h.

See Also

AttachPropertyInstance, AttachPropertyInstanceEx, RecognizeFrame