ParserAutoInstallInfo Callback Function

Articolo
11/09/2009

The ParserAutoInstallInfo export function identifies the parser, or parsers that are located in a DLL. ParserAutoInstallInfo should be implemented in all parser DLLs.

Syntax

PPF_PARSERDLLINFO WINAPI ParserAutoInstallInfo(void);

Parameters

This callback has no parameters.

Return Value

If the function is successful, the return value is a PF_PARSERDLLINFO structure that describes the parsers in the DLL.

If the function is unsuccessful, the return value is FALSE.

Remarks

When Network Monitor loads for the first time, it calls ParserAutoInstallInfo (if it exists) to automatically install each parser, and then enumerate all the parser DLLs in the parser subdirectory.

The information returned in the PF_PARSERDLLINFO structure includes the following:

The number of parsers in the DLL (typically one).
The name and a brief description of the protocol that each parser detects.
An optional Help file for each protocol.
The protocols that precede each protocol.
The protocols that follow each protocol.

Each parser DLL should contain one parser. However, Network Monitor allows you to create a DLL that contains more than one parser. For example, tcpip.dll is a Network Monitor DLL with more than one parser.

For information on	See
What parsers are, and how they work with Network Monitor.	Parsers
Which entry points are included in the parser DLL.	Parser DLL Architecture
How to implement ParserAutoInstallInfo— includes an example.	Implementing ParserAutoInstallInfo

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Header	Netmon.h

Condividi tramite