• BlackBerry Dynamics
  • Runtime library for Android applications
  • 10.2.0.79
GDAppResultCode Enum Reference

Constants for GDAppEvent result code. More...

Description

This enumeration represents the result code of a GDAppEvent that is being notified. The GDAppEvent.getResultCode() method will always return one of these values.

The code can be interpreted in conjunction with the event type, see GDAppEventType.

Public Attributes

 GDErrorNone =(GDAppResultCodeNDK.GDErrorNone)
 Used for all non-failure events. More...
 
 GDErrorActivationFailed =(GDAppResultCodeNDK.GDErrorActivationFailed)
 Device activation failed. Device activation is part of authorization processing. This code notifies the application that processing didn't succeed this time, but might succeed if another attempt is made. See under GDAndroid.authorize.
 
 GDErrorProvisioningFailed =(GDAppResultCodeNDK.GDErrorProvisioningFailed)
 Enterprise activation failed. Enterprise activation is part of authorization processing. This code notifies the application that processing didn't succeed this time, but might succeed if another attempt is made. See under GDAndroid.authorize.
 
 GDErrorPushConnectionTimeout =(GDAppResultCodeNDK.GDErrorPushConnectionTimeout)
 Connection to the Push Channel service failed but is required to complete authorization. This code notifies the application that authorization processing didn't succeed this time, but might succeed if another attempt is made. More...
 
 GDErrorAppDenied =(GDAppResultCodeNDK.GDErrorAppDenied)
 User not entitled. Authorization processing has completed, but the user isn't entitled to use this application. This code notifies the application that the BlackBerry Dynamics container has been wiped of all application data and authentication credentials. More...
 
 GDErrorAppVersionNotEntitled =(GDAppResultCodeNDK.GDErrorAppVersionNotEntitled)
 User not entitled to this version. Authorization processing has completed, but the user isn't entitled to this version of this application. This code notifies the application that the BlackBerry Dynamics container has been locked and isn't accessible. More...
 
 GDErrorIdleLockout =(GDAppResultCodeNDK.GDErrorIdleLockout)
 User inactive. The enterprise's security policies specify a time after which the application is to be locked, and the user has now been inactive for a period that exceeds this time. In effect, the user's authorization to access the application data has been withdrawn. This code notifies the application that the BlackBerry Dynamics unlock screen is active and therefore the application's own user interface mustn't be made active. More...
 
 GDErrorBlocked =(GDAppResultCodeNDK.GDErrorBlocked)
 Policy violation block. The enterprise's security policies specify a condition under which access is to be blocked, and that condition has occurred. In effect, the user's authorization to access the application data has been withdrawn. This code notifies the application that its user interface must not be made active. More...
 
 GDErrorWiped =(GDAppResultCodeNDK.GDErrorWiped)
 Policy violation wipe. The enterprise's security policies specify a condition under which the secure container is to be wiped, and that condition has occurred. This code notifies the application that the container has been wiped of all application data and authentication credentials. More...
 
 GDErrorRemoteLockout =(GDAppResultCodeNDK.GDErrorRemoteLockout)
 Remote lock-out. Either a remote lock command has been received from the enterprise management console,
or the security password on the device has been retried too often. In effect, the user's authorization to access the application data has been withdrawn. This code notifies the application that its user interface mustn't be made active. More...
 
 GDErrorPasswordChangeRequired =(GDAppResultCodeNDK.GDErrorPasswordChangeRequired)
 Password change required. The user's security password has expired, or no longer complies with enterprise security policy. In effect, the user's authorization to access the application data has been withdrawn. This code notifies the application that the BlackBerry Dynamics password change screen is active and therefore the application's own user interface mustn't be made active.
 
 GDErrorSecurityError =(GDAppResultCodeNDK.GDErrorSecurityError)
 Internal error: Secure store couldn't be unlocked.
 
 GDErrorProgrammaticActivationNoNetwork =(GDAppResultCodeNDK.GDErrorProgrammaticActivationNoNetwork)
 Programmatic activation connection failed. It wasn't possible to establish a data connection for programmatic activation. This code notifies the application that programmatic activation didn't succeed this time, but might succeed if another attempt is made. See under GDAndroid.authorize.
 
 GDErrorProgrammaticActivationCredentialsFailed =(GDAppResultCodeNDK.GDErrorProgrammaticActivationCredentialsFailed)
 Programmatic activation credentials failed. The credential values supplied for programmatic activation were rejected during some stage of activation processing. This code notifies the application that programmatic activation didn't succeed this time, but could succeed if another attempt is made with different credential values. See under GDAndroid.authorize.
 
 GDErrorProgrammaticActivationServerCommsFailed =(GDAppResultCodeNDK.GDErrorProgrammaticActivationServerCommsFailed)
 Programmatic activation server communication failed. A data connection was established but communication with a required server resource subsequently failed. This code notifies the application that programmatic activation didn't succeed this time, but could succeed if another attempt is made later. See under GDAndroid.authorize. More...
 
 GDErrorProgrammaticActivationUnknown =(GDAppResultCodeNDK.GDErrorProgrammaticActivationUnknown)
 Programmatic activation failed. A general failure occurred during programmatic activation processing. This code notifies the application that programmatic activation didn't succeed this time, but could succeed if another attempt is made. See under GDAndroid.authorize.
 
 GDErrorProgrammaticActivationAttestationFailed =(GDAppResultCodeNDK.GDErrorProgrammaticActivationAttestationFailed)
 Programmatic activation failed. Attestation failure occurred during programmatic activation processing. Check your app configuration and make sure the device is compatible with your enterprise policies.
 

Member Data Documentation

◆ GDErrorNone

GDErrorNone =(GDAppResultCodeNDK.GDErrorNone)

◆ GDErrorPushConnectionTimeout

GDErrorPushConnectionTimeout =(GDAppResultCodeNDK.GDErrorPushConnectionTimeout)

◆ GDErrorAppDenied

GDErrorAppDenied =(GDAppResultCodeNDK.GDErrorAppDenied)

If entitlement was withdrawn in error then, after reinstating entitlement, the following steps must be taken.

  1. The user must terminate the application on the device, for example, using the native task manager, and then restart the application.
  2. The application will then open as if being started for the first time.
  3. The user will then have to activate the application.

This code is utilized when the end user is not entitled to any version of the application. Compare the GDErrorAppVersionNotEntitled code, below.

See also
System administration tasks.

◆ GDErrorAppVersionNotEntitled

GDErrorAppVersionNotEntitled =(GDAppResultCodeNDK.GDErrorAppVersionNotEntitled)

If entitlement to the version is later granted, or reinstated, then the lock is removed. The device must be on-line and able to connect to the BlackBerry Dynamics infrastructure, and the user will have to re-authenticate, in order to complete the removal of the lock.

This code is utilized when the end user is entitled to at least one other version of the application, but not to the current version. Compare the GDErrorAppDenied code, above.

See also
System administration tasks.

◆ GDErrorIdleLockout

GDErrorIdleLockout =(GDAppResultCodeNDK.GDErrorIdleLockout)

The locked condition will be cleared when the user enters their password, at which point the application will be notified with a new event.

◆ GDErrorBlocked

GDErrorBlocked =(GDAppResultCodeNDK.GDErrorBlocked)

(Compare GDErrorWiped, below.)

This code may be set when, for example, connection to the BlackBerry Dynamics infrastructure hasn't been made for a specified interval. If the condition is cleared, the application will be notified with a new event.

◆ GDErrorWiped

GDErrorWiped =(GDAppResultCodeNDK.GDErrorWiped)

(Compare GDErrorBlocked, above, which also gives an example of a policy condition.)

After a device wipe, the application cannot be run until the following steps have been taken.

  1. The user must terminate the application on the device, for example, using the native task manager, and then restart the application.
  2. The application will then open as if being started for the first time.
  3. The user will then have to activate the application.

◆ GDErrorRemoteLockout

GDErrorRemoteLockout =(GDAppResultCodeNDK.GDErrorRemoteLockout)

The user's authorization will remain withdrawn until the lock is removed at the enterprise management console, and the end user has entered a special unlock code at the device.

◆ GDErrorProgrammaticActivationServerCommsFailed

GDErrorProgrammaticActivationServerCommsFailed =(GDAppResultCodeNDK.GDErrorProgrammaticActivationServerCommsFailed)

It is recommended not to make repeated attempts at programmatic activation with no delay between attempts. Instead, an exponential back-off algorithm should be used to calculate a delay.