Register Parser
The Register export function must be implemented in all parser DLLs. The implementation of Register creates and fills-in a property database for a protocol. Network Monitor uses the database to determine which properties the protocol supports.
VOIDRegister(HPROTOCOLhProtocol);
Parameters
- hProtocol
[in] The handle of the protocol that Network Monitor provides when calling Register. The hProtocol handle is needed when calling export helper functions.
Return Values
None.
Remarks
Network Monitor starts calling the Register function as soon as a capture is loaded. Network Monitor calls the Register function for each protocol it can identify. The CreateProtocol function passes a pointer to the Register function.
The implementation of Register includes calls to the following functions.
- A call to the CreatePropertyDatabase and AddProperty functions to create a database of all the properties that the protocol supports.
- A call to the CreateHandoffTable function is required if the protocol uses a handoff set.
If the parser DLL contains multiple parsers, and the parser can detect more than one protocol, you must implement a Register function for each protocol.
| 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 Register— includes an example. | Implementing Register |
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
AddProperty, CreateHandoffTable, CreatePropertyDatabase, CreateProtocol