# Print output for @column tags ?> TelephonyCallback.RegistrationFailedListener - Android SDK | Android Developers

Most visited

Recently visited

TelephonyCallback.RegistrationFailedListener

public static interface TelephonyCallback.RegistrationFailedListener

android.telephony.TelephonyCallback.RegistrationFailedListener


Interface for registration failures listener.

Summary

Public methods

abstract void onRegistrationFailed(CellIdentity cellIdentity, String chosenPlmn, int domain, int causeCode, int additionalCauseCode)

Report that Registration or a Location/Routing/Tracking Area update has failed.

Public methods

onRegistrationFailed

public abstract void onRegistrationFailed (CellIdentity cellIdentity, 
                String chosenPlmn, 
                int domain, 
                int causeCode, 
                int additionalCauseCode)

Report that Registration or a Location/Routing/Tracking Area update has failed.

Indicate whenever a registration procedure, including a location, routing, or tracking area update fails. This includes procedures that do not necessarily result in a change of the modem's registration status. If the modem's registration status changes, that is reflected in the onNetworkStateChanged() and subsequent get{Voice/Data}RegistrationState().

Because registration failures are ephemeral, this callback is not sticky. Registrants will not receive the most recent past value when registering.
Requires Manifest.permission.READ_PRECISE_PHONE_STATE and Manifest.permission.ACCESS_FINE_LOCATION

Parameters
cellIdentity CellIdentity: the CellIdentity, which must include the globally unique identifier for the cell (for example, all components of the CGI or ECGI). This value cannot be null.

chosenPlmn String: a 5 or 6 digit alphanumeric PLMN (MCC|MNC) among those broadcast by the cell that was chosen for the failed registration attempt. This value cannot be null.

domain int: DOMAIN_CS, DOMAIN_PS or both in case of a combined procedure. Value is NetworkRegistrationInfo.DOMAIN_UNKNOWN, NetworkRegistrationInfo.DOMAIN_CS, NetworkRegistrationInfo.DOMAIN_PS, or NetworkRegistrationInfo.DOMAIN_CS_PS

causeCode int: the primary failure cause code of the procedure. For GSM/UMTS (MM), values are in TS 24.008 Sec 10.5.95 For GSM/UMTS (GMM), values are in TS 24.008 Sec 10.5.147 For LTE (EMM), cause codes are TS 24.301 Sec 9.9.3.9 For NR (5GMM), cause codes are TS 24.501 Sec 9.11.3.2 Integer.MAX_VALUE if this value is unused.

additionalCauseCode int: the cause code of any secondary/combined procedure if appropriate. For UMTS, if a combined attach succeeds for PS only, then the GMM cause code shall be included as an additionalCauseCode. For LTE (ESM), cause codes are in TS 24.301 9.9.4.4. Integer.MAX_VALUE if this value is unused.