Packet Sniffer SDK VCL Edition

HNPSManager :: Methods :: InstallLoopBack

Installs current PSSDK version loopback driver.

Syntax:

function InstallLoopBack(pUniqueInstallId: PChar) : DWORD;

Parameters:

pUniqueInstallId

[in] Unique ID of the subject executing driver uninstallation.

Return values:

HNERR_OK	Driver installed successfully.
HNERR_WRONG_OS	This OS is not supported.
HNERR_DRIVER_NOT_LOADED	Packet Sniffer SDK internal driver loading error.
HNERR_INSTALL_DRIVER	Can't install Packet Sniffer SDK driver.

Description:

Since version 3.1 you can install PSSDK internal drivers statically using corresponding PSSDK functions, that allows your application to get full access to PSSDK functions under user account with restricted rights.

The driver installation process goes the following way:

1. PSSDK driver is copied in the %SYSTEM%\Drivers directory;

2. Driver is registered in the system registry;

3. Driver loading status is set as System (static loading, i.e. on the OS startup).

To use this function administrator rights are required. This function doesn't require PSSDK to be initialized.

Example:

DWORD Res = HNPSManager.InstallLoopBack(PChar("MyCompanyNameMyAppNameWhateverElse"));
if (Res == HNERR_OK) MessageBox(...);