MacHASP.h

Go to the documentation of this file.

/******************************************************
*
*  HaspCall.h
*
*  Defines the Interface for C programs to the MacHasp system.
*
*  Copyright Aladdin Knowledge Systems
*
*         
******************************************************/

#ifndef  MacHASPCH_def
#define  MacHASPCH_def 1


#include "MacHaspErrors.h"


/*
*  Valid MacHasp services.
*/
#define     SRV_ISHASP              1  /* how many MacHasp on this Mac */
#define     SRV_GET_CODE            2  /* get return code from a MacHasp */
#define     SRV_GET_HASP_TYPE    3  /* get the MacHasp type */
#define  SRV_READ_MEMO           4  /* read a memory byte */
#define  SRV_WRITE_MEMO       5  /* write a memory byte */
#define     SRV_READ_BLOCK       6  /* read memory block */
#define     SRV_WRITE_BLOCK         7  /* write memory block */
#define     SRV_READ_RAM            8  /* read RAM variable */
#define     SRV_WRITE_RAM           9  /* write RAM variable */
#define     SRV_READ_PRIVILEGE   10 /* read privileged area */
#define     SRV_WRITE_PRIVILEGE  11 /* write privileged area */
#define     SRV_MAXNET_STATIONS  12 /* get maximum netHASP stations */


/*
*  Valid MacNetHasp services.
*/
#define     SRV_NET_LOGIN                       41 /* NetHASP LOGIN*/
#define     SRV_NET_LOGOUT                   42 /* NetHASP LOGOUT*/
#define     SRV_NET_ExLOGOUT                 43 /* NetHASP External LOGOUT*/
#define     SRV_NET_GET_CODE                 44 /* get return code from a MacNetHasp */
#define     SRV_NET_GET_TYPE                 45 /* get MacNetHasp type */
#define  SRV_NET_READ_MEMO                46 /* read a memory byte */
#define  SRV_NET_WRITE_MEMO               47 /* write a memory byte */
#define     SRV_NET_READ_BLOCK               48 /* read memory block */
#define     SRV_NET_WRITE_BLOCK              49 /* write memory block */
#define     SRV_NET_READ_RAM                 50 /* read RAM variable */
#define     SRV_NET_WRITE_RAM                51 /* write RAM variable */
#define     SRV_NET_READ_PRIVILEGE        52 /* read privileged area */
#define     SRV_NET_WRITE_PRIVILEGE       53 /* write privileged area */
#define     SRV_NET_GET_LOGGEDIN          54 /* get number of logged in with the ProgNum and passwords stations */
#define     SRV_NET_GET_ALL_LOGGEDIN      55 /* get number of all logged in programs */
#define     SRV_NET_GET_PROG_INFO            56 /* get network addres of an logged in station */
#define     SRV_NET_SET_IDLE_LIMIT        57 /* Set IdleLimit in minutes for the program */
#define     SRV_NET_CHECK_COMPLETE        60 /* get data after completion of the asynchronies call */
#define     SRV_NET_SET_SERVER_ADDRESS 61 /* sets server's address 
                                                                  ServerNet=InputPrm2;
                                                                  ServerNode=InputPrm1;
                                                                  ServerSocket=MemoAddr;
                                                             */
#define     SRV_NET_GET_MONITOR_INFO         62 /* gets information for Monitor */
#define     SRV_NET_GET_MORE_MONITOR_INFO 63 /* gets information for Monitor */
#define     SRV_RELEASE_MONITOR_INFO         64 /* frees monitor info before removing the server */

#define     SRV_CHECK_FOR_COMPLETE        13       /* Check for completion of pervious asincronic call */
#define     HASP_NOWAIT_BIT               0x80000000L /* Last Service bit must be set for asinc. call */
#define     HASP_FROM_DT_BIT           0x40000000L /* This Service bit must be set for NetMacHASP Calls from Defered Task */
#define     ENV_LOGIN_BIT                 0x00008000L


/*
*  RUS services.
*/
#define     SRV_RUS_UPDATE                101   /* Update the MacHASP memory */
#define     SRV_RUS_CREATE_PASSW       102 /* Create RUS Passwords */
#define     SRV_RUS_GET_ID                103 /* Get RUS Session ID */

/*
* Special services.
* For Aladdin's internal usage only!
* Using these services may lead to crashes and
* bizzar behaviour of the system.
*/
#define SRV_HASP_USB_RESET             200
 


/*
* calling function prototype
*/

#ifdef __cplusplus
   extern "C" {
#endif

pascal long MacHasp(long Service, long HaspNum,
               long InputPrm1, long InputPrm2,
               long MemoAddr, long MemoData, Ptr MemoBuff,
               long *ReturnPrm1, long *ReturnPrm2, long *Status);
          
#ifdef __cplusplus
   }
#endif


/*
* Several parameters have different meaning depending on the Service:
*
* InputPrm1,
* InputPrm2 on GET_CODE are seed codes which can be set by the caller
*              to any value in the range (0..16777215)
*         on READ/WRITE MEMO, the caller must set them to the
*              correct passwords (read/write/write privileged area).
* MemoData on WRITE_MEMO: data to be written.
*          on BLOCK services: length of the memo buffer
* ReturnPrm1 on IS_HASP: Number of MacHasps connected
*            on GET_CODE: return code for the first Seed Code
*            on READ_MEMO: value of the memory byte read.
*          on GET_HASP_TYPE: type of the MacHasp.
* ReturnPrm2 on GET_CODE: return code for the second seed code.
*          on GET_HASP_TYPE: size of the MacHasp memory.
*
* Other parameters are used only by specific Services
*/ 


/*
* Privileged area limits
*/
#define        PRIVILEGED_LOW       0
#define        PRIVILEGED_HIGH         9
#define        PRIVILEGED_SIZE         PRIVILEGED_HIGH - PRIVILEGED_LOW + 1 

/*
* max. number of MacHasps which can be connected to the 
* same computer.
*/
#define MAX_ADB      15
#define MAX_USB      127

#define  MAX_HASP MAX_ADB + MAX_USB

/*
*  Net-MacHASP - Unlimited Idle Time Set
*/
#define  NETHASP_UNLIMITED_IDLE_TIME         0xFFFF      

/********************************************************
*
* Hasp resource definitions.
*
********************************************************/

#define HASP_RESOURCE_NAME "\pHaspResource"  /* filename of the HASP resource */
#define  HASP_RESOURCE_TYPE   'HASP'         /* Type of the HASP resource */
#define  HASP_RESOURCE_ID  128            /* ID of the HASP resource */
 

/*******************************************************
*
* Hasp resource definitions.
*
********************************************************/

#define NETH_RESOURCE_NAME "\pNetHaspResource"  /* filename of the NetHASP resource */
#define  NETH_RESOURCE_TYPE   'NETH'         /* Type of the NetHASP resource */
#define  NETH_RESOURCE_ID  128            /* ID of the NetHASP resource */
 

/*
* Declare a pointer to MacHasp(). from this file the call will be made
* through this pointer to the beginning of the resource, which should
* contain the MacHasp body itself.
*/
 
#ifdef __cplusplus
   extern "C" {
#endif

 typedef pascal long (*MacHaspPtr) (long,long,long,long,long,long,
                     Ptr, long *,long *,long *);


/*
* this function loads the HASP resource (opens resource file if need)
* and stores its address in a MacHaspPtr variable. 
* call it before any calls to MacHasp.
* You call this function only once, unless you call MacHaspClose.
*/
pascal short MacHaspInit(void);

/*
* This function releases the HASP resource from memory.
*/
pascal short MacHaspClose(void);


/*
* this function loads the NetHASP resource (opens resource file if need)
* and stores its address in a MacHaspPtr variable. 
* call it before any calls to MacHasp.
* You call this function only once, unless you call MacHaspClose.
*/
pascal short NetHaspInit(void);


/*
* This function releases the HASP resource from memory.
*/
pascal short NetHaspClose(void);

/* 
*  NetHASP Loader function prototype
*
*     pascal   short NetHASPLoad( long *ErrorCode2 , short SendRecieveTime); // returns ErrorCode1
*/
   
typedef  pascal short (*NHLoader)( long *, short, Handle );
 


#ifdef __cplusplus
   }
#endif

#define  FAS_UNLIMITED_RT  0xFFFF
   

#endif  // #ifndef   MacHASPCH_def

---