DestroyPropertyDatabase
The DestroyPropertyDatabase function releases the resources used to create the protocol property database.
DWORD WINAPIDestroyPropertyDatabase(HPROTOCOLhProtocol);
Parameters
- hProtocol
[in] Handle to the property database to be destroyed. The handle is passed to the parser DLL when Network Monitor calls the Deregister function.
Return Values
If the function is successful, the return value is NMERR_SUCCESS.
If the function is unsuccessful, the return value is an error code.
| Return code | Description |
|---|---|
| NMERR_INTERNAL_ERROR | An internal error occurred. |
| NMERR_INVALID_HPROTOCOL | Invalid handle in hProtocol. |
Remarks
The DestroyPropertyDatabase function should be called only when implementing the Deregister export function for the protocol. For parser DLLs that support multiple protocols, the DestroyPropertyDatabase function is called for each implementation of Deregister.
| 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 Deregister— includes an example. | Implementing Deregister |
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. |
| Library | Link to Nmapi.lib. |
| DLL | Requires Nmapi.dll. |