The ACG_RETURN_CODES enumeration is used in several COM-Activator function calls as a reference parameter. Its value after the call indicates the outcome of an operation. "True" values are greater than or equal to 100 and less than 500. "False" values are greater than or equal to 500.

enum ACG_RETURN_CODES { ACG_TRUE_ACT_CODE_GENERATED = 100, ACG_TRUE_FORMAT_OK = 101, ACG_TRUE_DEACTIVATED = 102, ACG_FALSE_MISSING_MAIN_LF = 500, ACG_FALSE_MAIN_LF_CORRUPT = 501, ACG_FALSE_BAD_MAIN_LF_FILENAME = 502, ACG_FALSE_DEACTIVATION_ID_ONLY = 600, ACG_FALSE_CODE_INVALID_BAD_ID = 601, ACG_FALSE_CODE_BAD_FORMAT = 602, ACG_FALSE_PARAM_OUT_OF_RANGE = 700, ACG_FALSE_FP_OUT_OF_RANGE = 701, ACG_FALSE_WRONG_PARAM_TYPE = 702, ACG_FALSE_SHELF_LIFE_OUT_OF_RANGE = 703, ACG_FALSE_INVALID_AUTH_ID = 704, ACG_FALSE_INTERNAL_FAILURE = 901 };

The meaning of a particular ACG_RETURN_CODES depends on the context from which it was returned.  See the specific  function reference in this section for more information on the exact meaning of a particular ACG_RETURN_CODES value.

The following descriptions of meaning is meant as a guide.

ACG_RETURN_CODES Meaning:

ACG_TRUE_ACT_CODE_GENERATED: This true value indicates that a function call successfully resulted in the generation of an Activation Code.

 

ACG_TRUE_FORMAT_OK: This true value indicates that a function call successfully parsed an Authorization Request Code and determined its format was valid.

 

ACG_TRUE_DEACTIVATED: This true value indicates that a function call successfully parsed a Deactivation Confirmation Code and determined that the license from which it was generated had been deactivated.

 

ACG_FALSE_MISSING_MAIN_LF: This false value indicates that a function call failed because the specified license project file was not found.

 

ACG_FALSE_MAIN_LF_CORRUPT: This false value indicates that a function call failed because the specified license project file was found, but could not be loaded.

 

ACG_FALSE_BAD_MAIN_LF_FILENAME: This false value indicates that a function call failed because the specified license project file name was invalid (not the correct file extension: LPJ). Keep in mind that the COM-Activator only works with license project files and cannot open distributed license files.

 

ACG_FALSE_DEACTIVATION_ID_ONLY: This false value indicates that a function call failed because the entered Authorization Request Code was actually a Deactivation Confirmation Code.  Activation Codes are never generated for Deactivation Confirmation Codes.

 

ACG_FALSE_CODE_INVALID_BAD_ID: This false value indicates that a function call failed because an Authorization Request Code contained an Authorization Definition ID was not valid for the specified license.

 

ACG_FALSE_CODE_BAD_FORMAT: This false value indicates that a function call failed because a specified Authorization Request Code was in an invalid format.

 

ACG_FALSE_PARAM_OUT_OF_RANGE: This false value indicates that a function call failed because a specified parameter value was not within the required range.

 

ACG_FALSE_FP_OUT_OF_RANGE: This false value indicates that a function call failed because a specified embedded FingerPrint value was not within the required range.

 

ACG_FALSE_WRONG_PARAM_TYPE: This false value indicates that a function call failed because a specified Authorization Definition ID (identified either by an override or an Authorization Request Code) takes a parameter of a different type from that required by the function call that failed.

 

ACG_FALSE_SHELF_LIFE_OUT_OF_RANGE: This false value indicates that a function call failed because a specified Shelf-Life was not in a valid range.

 

ACG_FALSE_INVALID_AUTH_ID: This false value indicates that a function call failed because a specified Authorization Definition ID was not valid for the specified license.

 

ACG_FALSE_INTERNAL_FAILURE: This false value indicates that an exception occurred inside the COM-Activator that should have been handled.  If you get this ACG_RETURN_CODES value, it indicates a bug in the software. If you receive this value, please contact us with the exact steps to reproduce the ACG_FALSE_INTERNAL_FAILURE value.

 

Note: The COM Activator only comes with the Enterprise, Internet and Server Editions of the SoftwareShield SDK.