hnpssdk.h

Network Stats using PSSDK

/****************************************************************************
**                                                                         **
**                     PSSDK Function Definitions module                   **
**            Copyright (c) 1997 - 2007 microOLAP Technologies LTD,        **
**                       Khalturin A.P., Naumov D.A.                       **
**                               Header File                               **
**                                                                         **
****************************************************************************/

//---------------------------------------------------------------------------
#ifndef __HN_PSSDK_H__
#define __HN_PSSDK_H__ 
//---------------------------------------------------------------------------

//---------------------------------------------------------------------------
#ifdef  __cplusplus
extern "C" {
#endif
    //---------------------------------------------------------------------------

    //###########################################################################
    //                             PSSDK MANAGER
    //###########################################################################

    //---------------------------------------------------------------------------
    // MgrCreate - Creates an HNPSManager object.
    HANDLE __stdcall MgrCreate();
    typedef HANDLE (__stdcall *FN_MgrCreate)();

    //---------------------------------------------------------------------------
    // MgrDestroy - Destroys an HNPSManager object.
    DWORD  __stdcall MgrDestroy(HANDLE hMgr);
    typedef DWORD (__stdcall *FN_MgrDestroy)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrAbout - Displays information about Packet Sniffer SDK.
    VOID   __stdcall MgrAbout(HANDLE hMgr);
    typedef VOID (__stdcall *FN_MgrAbout)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrGetVersionA - Returns the version number of the Packet Sniffer SDK library.
    LPCSTR __stdcall MgrGetVersionA(HANDLE hMgr);
    typedef LPCSTR (__stdcall *FN_MgrGetVersionA)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrGetBuildA - Returns the build number of the Packet Sniffer SDK library.
    LPCSTR __stdcall MgrGetBuildA(HANDLE hMgr);
    typedef LPCSTR (__stdcall *FN_MgrGetBuildA)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrGetVersionW - Returns the version number of the Packet Sniffer SDK library.
    LPCWSTR __stdcall MgrGetVersionW(HANDLE hMgr);
    typedef LPCWSTR (__stdcall *FN_MgrGetVersionW)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrGetBuildW - Returns the build number of the Packet Sniffer SDK library.
    LPCWSTR __stdcall MgrGetBuildW(HANDLE hMgr);
    typedef LPCWSTR (__stdcall *FN_MgrGetBuildW)(HANDLE hMgr);

#ifdef UNICODE
    #define MgrGetVersion MgrGetVersionW
    #define MgrGetBuild   MgrGetBuildW
#else
    #define MgrGetVersion MgrGetVersionA
    #define MgrGetBuild   MgrGetBuildA
#endif // !UNICODE

    //---------------------------------------------------------------------------
    // MgrGetWanMonitorState - Returns the WANMonitor installation status.
    BOOL  __stdcall MgrGetWanMonitorState(HANDLE hMgr);
    typedef BOOL  (__stdcall *FN_MgrGetWanMonitorState)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrSetWanMonitorState - Sets the WANMonitor installation status.
    BOOL  __stdcall MgrSetWanMonitorState(HANDLE hMgr, BOOL bEnable);
    typedef BOOL  (__stdcall *FN_MgrSetWanMonitorState)(HANDLE hMgr, BOOL bEnable);

    //---------------------------------------------------------------------------
    // MgrInitialize - Initializes Packet Sniffer SDK.
    DWORD  __stdcall MgrInitialize(HANDLE hMgr);
    typedef DWORD  (__stdcall *FN_MgrInitialize)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrGetAdaptersCfgCount - Returns the number of the HNAdapterConfig objects.
    DWORD  __stdcall MgrGetAdaptersCfgCount(HANDLE hMgr);
    typedef DWORD  (__stdcall *FN_MgrGetAdaptersCfgCount)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrGetFirstAdapterCfg - Returns the handle of the first HNAdapterConfig object.
    HANDLE __stdcall MgrGetFirstAdapterCfg(HANDLE hMgr);
    typedef HANDLE (__stdcall *FN_MgrGetFirstAdapterCfg)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrGetNextAdapterCfg - Returns the handle of the next HNAdapterConfig object.
    HANDLE __stdcall MgrGetNextAdapterCfg(HANDLE hMgr, HANDLE hCfg);
    typedef HANDLE (__stdcall *FN_MgrGetNextAdapterCfg)(HANDLE hMgr, HANDLE hCfg);

    //---------------------------------------------------------------------------
    // MgrRefreshAdapterList - Refreshes the internal list of the HNAdapterConfig objects.
    DWORD __stdcall MgrRefreshAdapterList(HANDLE hMgr);
    typedef DWORD (__stdcall *FN_MgrRefreshAdapterList)(HANDLE hMgr);

    //---------------------------------------------------------------------------
    // MgrSetOnConfigChange - Sets the OnConfigChange event.
    FARPROC __stdcall MgrSetOnConfigChange(HANDLE hMgr, FARPROC pfOnConfigChange, DWORD_PTR Param);
    typedef FARPROC (__stdcall *FN_MgrSetOnConfigChange)(HANDLE hMgr, FARPROC pfOnConfigChange, DWORD_PTR Param);

    //---------------------------------------------------------------------------
    // v3.1 - MgrIsInitialized - Return PSSDK initialization status
    BOOL __stdcall MgrIsInitialized(HANDLE hMgr);    
    typedef BOOL (__stdcall *FN_MgrIsInitialized)(HANDLE hMgr);
    
    //---------------------------------------------------------------------------
    // v3.1 - MgrIsProtocolInstalled - Return status of installation the protocol driver of the current PSSDK version
    BOOL __stdcall MgrIsProtocolInstalled();
    typedef BOOL (__stdcall *FN_MgrIsProtocolInstalled)();

    //---------------------------------------------------------------------------
    // v3.1 - MgrInstallProtocolA - Install protocol driver for current PSSDK version
    DWORD __stdcall MgrInstallProtocolA(LPCSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrInstallProtocolA)(LPCSTR pUniqueInstallID);

    //---------------------------------------------------------------------------
    // v3.1 - MgrUninstallProtocolA - Uninstall protocol driver for current PSSDK version
    DWORD __stdcall MgrUninstallProtocolA(LPCSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrUninstallProtocolA)(LPCSTR pUniqueInstallID);

    //---------------------------------------------------------------------------
    // v3.1 - MgrInstallProtocolW - Install protocol driver for current PSSDK version
    DWORD __stdcall MgrInstallProtocolW(LPCWSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrInstallProtocolW)(LPCWSTR pUniqueInstallID);

    //---------------------------------------------------------------------------
    // v3.1 - MgrUninstallProtocolW - Uninstall protocol driver for current PSSDK version
    DWORD __stdcall MgrUninstallProtocolW(LPCWSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrUninstallProtocolW)(LPCWSTR pUniqueInstallID);

#ifdef UNICODE
    #define MgrInstallProtocol   MgrInstallProtocolW
    #define MgrUninstallProtocol MgrUninstallProtocolW
#else
    #define MgrInstallProtocol   MgrInstallProtocolA
    #define MgrUninstallProtocol MgrUninstallProtocolA
#endif // !UNICODE

    //---------------------------------------------------------------------------
    // v3.1 - MgrIsLoopBackInstalled - Return status of the loopback driver installation for current version of PSSDK
    BOOL __stdcall MgrIsLoopBackInstalled();
    typedef BOOL (__stdcall *FN_MgrIsLoopBackInstalled)();

    //---------------------------------------------------------------------------
    // v3.1 - MgrInstallLoopBackA - Install loopback driver for current version of PSSDK
    DWORD __stdcall MgrInstallLoopBackA(LPCSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrInstallLoopBackA)(LPCSTR pUniqueInstallID);

    //---------------------------------------------------------------------------
    // v3.1 - MgrUninstallLoopBackA - Uninstall loopback driver for current version of PSSDK
    DWORD __stdcall MgrUninstallLoopBackA(LPCSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrUninstallLoopBackA)(LPCSTR pUniqueInstallID);

    //---------------------------------------------------------------------------
    // v3.1 - MgrInstallLoopBackW - Install loopback driver for current version of PSSDK
    DWORD __stdcall MgrInstallLoopBackW(LPCWSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrInstallLoopBackW)(LPCWSTR pUniqueInstallID);

    //---------------------------------------------------------------------------
    // v3.1 - MgrUninstallLoopBackW - Uninstall loopback driver for current version of PSSDK
    DWORD __stdcall MgrUninstallLoopBackW(LPCWSTR pUniqueInstallID);
    typedef DWORD (__stdcall *FN_MgrUninstallLoopBackW)(LPCWSTR pUniqueInstallID);

#ifdef UNICODE
    #define MgrInstallLoopBack   MgrInstallLoopBackW
    #define MgrUninstallLoopBack MgrUninstallLoopBackW
#else
    #define MgrInstallLoopBack   MgrInstallLoopBackA
    #define MgrUninstallLoopBack MgrUninstallLoopBackA
#endif // !UNICODE

    //---------------------------------------------------------------------------
    // v3.1 - MgrUnloadProtocolNtDriver - unload protocol driver for current version of PSSDK (windows nt/2k/xp/2k3/vista)
    DWORD __stdcall MgrUnloadProtocolNtDriver();
    typedef DWORD (__stdcall *FN_MgrUnloadProtocolNtDriver)();

    //###########################################################################
    //                             PSSDK PACKET
    //###########################################################################
    //---------------------------------------------------------------------------
    // v2.2 - PktCreate - Creates the HNPacket object.
    HANDLE __stdcall PktCreate(DWORD MaxPacketSize);
    typedef HANDLE (__stdcall *FN_PktCreate)(DWORD MaxPacketSize);

    //---------------------------------------------------------------------------
    // v2.2 - PktDestroy - Destroys the HNPacket object.
    DWORD __stdcall PktDestroy(HANDLE hPkt);
    typedef DWORD (__stdcall *FN_PktDestroy)(HANDLE hPkt);

    //---------------------------------------------------------------------------
    // v2.2 - PktGetMediumType - Returns the network adapter type.
    DWORD __stdcall PktGetMediumType(HANDLE hPkt);
    typedef DWORD (__stdcall *FN_PktGetMediumType)(HANDLE hPkt);

    //---------------------------------------------------------------------------
    // v2.3 - PktSetMediumType - Sets the network adapter type.
    DWORD __stdcall PktSetMediumType(HANDLE hPkt, DWORD MediumType);
    typedef DWORD (__stdcall *FN_PktSetMediumType)(HANDLE hPkt, DWORD MediumType);

    //---------------------------------------------------------------------------
    // v2.2 - PktGetUserData - Returns the value definded by the user.
    DWORD_PTR __stdcall PktGetUserData(HANDLE hPkt);
    typedef DWORD_PTR (__stdcall *FN_PktGetUserData)(HANDLE hPkt);

    //---------------------------------------------------------------------------
    // v2.2 - PktSetUserData - Sets the value definded by the user.
    DWORD_PTR __stdcall PktSetUserData(HANDLE hPkt, DWORD_PTR UserData);
    typedef DWORD_PTR (__stdcall *FN_PktSetUserData)(HANDLE hPkt, DWORD_PTR UserData);

    //---------------------------------------------------------------------------
    // v2.2 - PktGetId - Returns the packet number.
#ifdef _WIN64
    ULONGLONG __stdcall PktGetId(HANDLE hPkt);
    typedef ULONGLONG (__stdcall *FN_PktGetId)(HANDLE hPkt);
#else
    DWORD __stdcall PktGetId(HANDLE hPkt, DWORD *pHiValue);
    typedef DWORD (__stdcall *FN_PktGetId)(HANDLE hPkt, DWORD *pHiValue);
#endif

    //---------------------------------------------------------------------------