Packet Sniffer SDK DLL Edition

HNPSManager :: Methods :: MgrInitialize

Initializes Packet Sniffer SDK library.

Syntax:

DWORD __stdcall MgrInitialize(HANDLE hMgr);

Parameters:

hMgr

[in] HNPSManager object handle.

Return values:

HNERR_OK	Packet Sniffer SDK initialization completed successfully.
HNERR_WRONG_OS	Packet Sniffer SDK does not support this OS version.
HNERR_DRIVER_NOT_LOADED	Packet Sniffer SDK internal driver loading error
HNERR_CONTROL_NOT_OPENED	Control device opening error.
HNERR_REG_OPEN_ERROR	OS registry reading error.
HNERR_INVALID_HANDLE	HNPSManager component has been created with an error.

Description:

To start working with the Packet Sniffer SDK call MgrInitialize function to initialize it. This function dynamically loads Packet Sniffer SDK internal driver.

On initializing Packet Sniffer SDK successfully HNPSManager object creates an internal list of HNAdapterConfig objects.

Each HNAdapterConfig object contains the information about the corresponding network adapter installed on the system. To gain access to HNAdapterConfig objects please use the MgrGetAdaptersCfgCount function, and MgrGetFirstAdapterCfg and MgrGetNextAdapterCfg functions.

Also, if you set an OnConfigChange event handler before MgrInitialize function is called, it will be convenient to process information concerning every network adapter using HNAdapterConfig object.

To use this function administrator rights are required.