Packet Sniffer SDK DLL Edition

HNPSManager :: Methods :: MgrRefreshAdapterList

Refreshes the internal list of the HNAdapterConfig objects.

Syntax:

DWORD __stdcall MgrRefreshAdapterList(HANDLE hMgr);

Parameters:

hMgr

[in] HNPSManager object handle.

Return values:

HNERR_OK	No errors.
HNERR_ADAPTER_ALREADY_OPENED	Refreshing of the HNAdapterConfig objects internal list can be executed only if there are no adapters already opened.
HNERR_REG_OPEN_ERROR	OS registry reading error.
HNERR_INVALID_HANDLE	HNPSManager component has been created with an error.

Description:

MgrRefreshAdapterList can be used only after MgrInitialize function has been executed successfully.

Use this function if you need to refresh the networks adapters list and/or WANMonitorState property changes. MgrRefreshAdapterList function performs full refreshing of all adapters configurations.

Also you can trace Windows messages (e.g., WM_DEVICECHANGE) concerning with hardware configuration changes, and handle them using this function.

On executing MgrRefreshAdapterList successfully OnConfigChange event handler is called.