The AIDA_boAuthenticateApplication function unlocks the AIDA API for the usage by an application.
Precondition is that previously AIDA_boLoadLicenseFile() has been called successfully
and pbMD5Digest has been calculated using AIDA_boGetSeedForApplicationAuthentication()
and LICU_boCalculateMD5().
bool AIDA_boAuthenticateApplication(
byte pbMD5Digest[AIDA_nMD5DigestSize]
);
AIDA_boAuthenticateApplication returns true only if the authentication is successful. In this case the AIDA API is unlocked for the usage by the calling application.
If the function fails, the returned value is false. The application can retrieve the error code using AIDA_iGetError().
Possible licensing-specific error codes set by this function are:
EOSAL_LICENSE_NOT_FOUND: The license file could not be found or the access was denied. AIDA_boLoadLicenseFile() has not been called successfully before.
EOSAL_LICENSE_INVALID: The licence signature or the licence file name are invalid. AIDA_boLoadLicenseFile() has not been called successfully before.
EOSAL_BAD_CONFIGURATION: The license file does not contain all required data.
EOSAL_LICENSE_EXPIRED: The licence file is expired.
EOSAL_APPL_OR_PIMOD_NOT_LICENSED: AIDA is not licensed for the calling application. AIDA_boLoadLicenseFile() has not been called successfully before.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Linux: Requires a kernel supporting ELF binaries.
Header: Declared in bsk_aida.h, also requires portab.h.
Import Library (Windows): Use BSK_AIDA.lib.
AIDA Overview, AIDA Stacks Licensing/Authentication Overview, AIDA Functions
Other Licensing/Authentication Functions: AIDA_boLoadLicenseFile, AIDA_boGetLicenseInfo, AIDA_boGetSeedForApplicationAuthentication
Directly Affected Stack Manipulation Functions: AIDA_hCreateStack, AIDA_hCreateStackEx, AIDA_hRestoreStack, AIDA_hRestoreStackRaw, AIDA_hRestoreStackEx, AIDA_bAddToStack