Share via


TelephonyCallback.IRegistrationFailedListener.OnRegistrationFailed Method

Definition

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

[Android.Runtime.Register("onRegistrationFailed", "(Landroid/telephony/CellIdentity;Ljava/lang/String;III)V", "GetOnRegistrationFailed_Landroid_telephony_CellIdentity_Ljava_lang_String_IIIHandler:Android.Telephony.TelephonyCallback/IRegistrationFailedListenerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)]
public void OnRegistrationFailed (Android.Telephony.CellIdentity cellIdentity, string chosenPlmn, int domain, int causeCode, int additionalCauseCode);
[<Android.Runtime.Register("onRegistrationFailed", "(Landroid/telephony/CellIdentity;Ljava/lang/String;III)V", "GetOnRegistrationFailed_Landroid_telephony_CellIdentity_Ljava_lang_String_IIIHandler:Android.Telephony.TelephonyCallback/IRegistrationFailedListenerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)>]
abstract member OnRegistrationFailed : Android.Telephony.CellIdentity * string * int * int * int -> unit

Parameters

cellIdentity
CellIdentity

the CellIdentity, which must include the globally unique identifier for the cell (for example, all components of the CGI or ECGI).

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.

domain
Int32

DOMAIN_CS, DOMAIN_PS or both in case of a combined procedure.

causeCode
Int32

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
Int32

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.

Attributes

Remarks

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.

The calling app should have carrier privileges (see TelephonyManager#hasCarrierPrivileges) if it does not have the android.Manifest.permission#READ_PRECISE_PHONE_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION.

If the calling app doesn't have android.Manifest.permission#ACCESS_FINE_LOCATION, it will receive CellIdentity without location-sensitive information included.

Java documentation for android.telephony.TelephonyCallback.RegistrationFailedListener.onRegistrationFailed(android.telephony.CellIdentity, java.lang.String, int, int, int).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to