DestroyPropertyDatabase function

The DestroyPropertyDatabase function releases the resources used to create the protocol property database.

Syntax

DWORD WINAPI DestroyPropertyDatabase(
  _In_ HPROTOCOL hProtocol
);

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 value

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

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Netmon.h
Library
Nmapi.lib
DLL
Nmapi.dll

See also

Deregister