Frequently asked question

Are there API references for authorizing/deauthorizing ASR licenses?

Last Published: April 25, 2020

Answer



** Internal Publish Only! This article may contain information that is not intended for external circulation. **



Yes, as follows:

AuthorizeASR

Authorizes an ASR from a given string.

Syntax

HRESULT AuthorizeASR(BSTR strAsr, BSTR password)

Parameters

The AuthorizeASR function uses the following parameters:

Parameter Description strAsr ASR string. password Password string.

Return Values

The following values are returned by AuthorizeASR:

Return Value Description HRESULT S_OK if success, E_FAIL if error.

Error Returns

If HRESULT is equal to E_FAIL, run get_LastError to view a description of the error.

Possible error codes and messages for AuthorizeASR: · -1: “Could not process ASR” · -2: “ArcGIS Licensing handle error” · -3: “Invalid Password” · -4: “ASR is invalid or corrupt” · -98: “Could not load AfCore.dll”
  AuthorizeASRFromFile

Authorizes an ASR from a file.

Syntax

HRESULT AuthorizeASRFromFile(BSTR fileName, BSTR password)

Parameters

The AuthorizeASRFromFile function uses the following parameters:

Parameter Description fileName ASR file path. password Password string.

Return Values

The following values are returned by AuthorizeASRFromFile:

Return Value Description HRESULT S_OK if success, E_FAIL if error.

Error Returns

If HRESULT is equal to E_FAIL, run get_LastError to view a description of the error.

Possible error codes and messages for AuthorizeASRFromFile: · -1: “Could not process ASR” · -2: “ArcGIS Licensing handle error” · -3: “Invalid Password” · -4: “ASR is invalid or corrupt” · -98: “Could not load AfCore.dll”
  DeauthorizeASR

Deauthorizes an ASR from a given string.

Syntax

HRESULT DeauthorizeASR(BSTR strAsr, BSTR password)

Parameters

The DeauthorizeASR function uses the following parameters:

Parameter Description strAsr ASR string. password Password string.

Return Values

The following values are returned by DeauthorizeASR:

Return Value Description HRESULT S_OK if success, E_FAIL if error.

Error Returns

If HRESULT is equal to E_FAIL, run get_LastError to view a description of the error.

Possible error codes and messages for DeauthorizeASR: · -1: “Could not process ASR” · -2: “ArcGIS Licensing handle error” · -3: “Invalid Password” · -4: “ASR is invalid or corrupt” · -98: “Could not load AfCore.dll”
  DeauthorizeASRFromFile

Deauthorizes an ASR from a file.

Syntax

HRESULT DeauthorizeASRFromFile(BSTR fileName, BSTR password)

Parameters

The DeauthorizeASRFromFile function uses the following parameters:

Parameter Description fileName ASR file path. password Password string.

Return Values

The following values are returned by DeauthorizeASRFromFile:

Return Value Description HRESULT S_OK if success, E_FAIL if error.

Error Returns

If HRESULT is equal to E_FAIL, run get_LastError to view a description of the error.

Possible error codes and messages for DeauthorizeASRFromFile: · -1: “Could not process ASR” · -2: “ArcGIS Licensing handle error” · -3: “Invalid Password” · -4: “ASR is invalid or corrupt” · -98: “Could not load AfCore.dll”

Article ID:000011429

Software:
  • ArcMap

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options

Discover more on this topic