Register Parser Callback Function
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.
Syntax
VOID Register(
__in HPROTOCOL hProtocol
);
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 Value
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
| Minimum supported client | Windows 2000 Professional |
| Minimum supported server | Windows 2000 Server |
| Header | Netmon.h |
See Also
Send comments about this topic to Microsoft
Build date: 11/9/2009