PF_PARSERINFO

The PF_PARSERINFO structure defines one parser at a time. In the PF_PARSERINFO structure, a parser is defined by the information about the protocol that the parser detects.

typedef struct _PF_PARSERINFO {
  char szProtocolName[MAX_PROTOCOL_NAME_LEN];
  char szComment[MAX_PROTOCOL_COMMENT_LEN];
  char szHelpFile[MAX_PATH];
  PPF_FOLLOWSET pWhoCanPrecedeMe;
  PPF_FOLLOWSET pWhoCanFollowMe;
  PPF_HANDOFFSET pWhoHandsOffToMe;
  PPF_HANDOFFSET pWhoDoIHandOffTo;
} PF_PARSERINFO, 
 *PPF_PARSERINFO;

Members

• szProtocolName
  Name of the protocol that the parser detects.
• szComment
  Brief description of the protocol.
• szHelpFile
  Name of the protocol Help file, if any.
• pWhoCanPrecedeMe
  Pointer to a PF_FOLLOWSET structure that lists the protocols that can precede the protocol the PF_PARSERINFO structure describes. Network Monitor adds the parser protocol to the follow set of all the protocols in the set.
• pWhoCanFollowMe
  Pointer to a PF_FOLLOWSET structure that lists the protocol that can follow the protocol the PF_PARSERINFO structure describes. Network Monitor adds the protocols of the set to the follow set of the parser protocol.
• pWhoHandsOffToMe
  Pointer to a PF_HANDOFFSET structure that hands-off to the protocol that the PF_PARSERINFO structure describes. Network Monitor adds the parser protocol to the handoff sets of all the protocols in the set.
• pWhoDoIHandOffTo
  Pointer to a PF_HANDOFFSET structure that lists the protocols that the parser protocol hands off to. Network Monitor adds the protocols of this set to the handoff set of the parser protocol.

Remarks

The PF_PARSERINFO structure is used in the PF_PARSERDLLINFO structure to provide a description of a parser. Network Monitor uses the parser description to update the Parser.ini file, and the INI files of the parsers that precede and follow the protocol described in the PF_PARSERINFO structure.

A follow set specifies the protocols that follow a protocol. Network Monitor uses a follow set when the parser cannot identify the next protocol from the data in a protocol instance. A follow set is stored in the Parser.ini file. When the parser is installed for the first time, Network Monitor updates the follow set of the parser protocols that are listed in pWhoCanPrecedeMe and pWhoCanFollowMe.

A handoff set specifies the protocols that follow a protocol. The parser uses a handoff set only when the parser can identify the next protocol from the data in a protocol instance. A handoff set is stored in the INI files of each parser. When the parser is installed for the first time, Network Monitor updates the handoff set of the parser protocols that are listed in pWhoHandsOffToMe and pWhoDoIHandOffTo.

Requirements

See Also

ParserAutoInstallInfo, PF_FOLLOWSET, PF_HANDOFFSET, PF_PARSERDLLINFO