Added in API level 36

GetValueResult

---

Kotlin |Java

class GetValueResult : Parcelable

kotlin.Any
↳	android.service.settings.preferences.GetValueResult

Result object given a corresponding GetValueRequest.

• If the request was successful, getResultCode will be RESULT_OK, getValue will be populated with the settings preference value and getMetadata will be populated with its metadata.
• If the request is unsuccessful, getResultCode be a value other than RESULT_OK - see documentation for those possibilities to understand the cause of the failure.

Summary

Nested classes
	Builder Builder to construct GetValueResult.

Constants
static Int	RESULT_DISALLOW Requested preference is not allowed for access in this API under the current device policy.
static Int	RESULT_INTERNAL_ERROR API call failed due to an issue with the service binding.
static Int	RESULT_INVALID_REQUEST Request object is not valid.
static Int	RESULT_OK Request is successful.
static Int	RESULT_REQUIRE_APP_PERMISSION Requested preference requires permissions not held by the calling application.
static Int	RESULT_UNAVAILABLE Preference is currently not available, likely due to device state or the state of a dependency.
static Int	RESULT_UNSUPPORTED Requested preference is not supported by this API.

Inherited constants

From class Parcelable Int CONTENTS_FILE_DESCRIPTOR Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor. Int PARCELABLE_WRITE_RETURN_VALUE Flag for use with writeToParcel: the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)". Some implementations may want to release resources at this point.

Public methods
SettingsPreferenceMetadata?	getMetadata() Returns the metadata of requested Preference if request successful.
Int	getResultCode() Returns the result code indicating status of the request.
SettingsPreferenceValue?	getValue() Returns the value of requested Preference if request successful.

Properties
static Parcelable.Creator<GetValueResult!>	CREATOR Parcelable Creator for GetValueResult.

Constants

RESULT_DISALLOW

Added in API level 36

static val RESULT_DISALLOW: Int

Requested preference is not allowed for access in this API under the current device policy.

Retry may succeed if underlying conditions change.

Value: 4

RESULT_INTERNAL_ERROR

Added in API level 36

static val RESULT_INTERNAL_ERROR: Int

API call failed due to an issue with the service binding.

Retry may succeed.

Value: 6

RESULT_INVALID_REQUEST

Added in API level 36

static val RESULT_INVALID_REQUEST: Int

Request object is not valid.

Retry not advised with current parameters.

Value: 5

RESULT_OK

Added in API level 36

static val RESULT_OK: Int

Request is successful.

Value: 0

RESULT_REQUIRE_APP_PERMISSION

Added in API level 36

static val RESULT_REQUIRE_APP_PERMISSION: Int

Requested preference requires permissions not held by the calling application.

Retry may succeed if necessary permissions are obtained.

Value: 3

RESULT_UNAVAILABLE

Added in API level 36

static val RESULT_UNAVAILABLE: Int

Preference is currently not available, likely due to device state or the state of a dependency.

Retry may succeed if underlying conditions change.

Value: 2

RESULT_UNSUPPORTED

Added in API level 36

static val RESULT_UNSUPPORTED: Int

Requested preference is not supported by this API.

Retry not advised.

Value: 1

Public methods

getMetadata

Added in API level 36

fun getMetadata(): SettingsPreferenceMetadata?

Returns the metadata of requested Preference if request successful.

getResultCode

Added in API level 36

fun getResultCode(): Int

Returns the result code indicating status of the request.

Return

Int

Value is android.service.settings.preferences.GetValueResult#RESULT_OK, android.service.settings.preferences.GetValueResult#RESULT_UNSUPPORTED, android.service.settings.preferences.GetValueResult#RESULT_UNAVAILABLE, android.service.settings.preferences.GetValueResult#RESULT_REQUIRE_APP_PERMISSION, android.service.settings.preferences.GetValueResult#RESULT_DISALLOW, android.service.settings.preferences.GetValueResult#RESULT_INVALID_REQUEST, or android.service.settings.preferences.GetValueResult#RESULT_INTERNAL_ERROR

getValue

Added in API level 36

fun getValue(): SettingsPreferenceValue?

Returns the value of requested Preference if request successful.

Properties

CREATOR

Added in API level 36

static val CREATOR: Parcelable.Creator<GetValueResult!>

Parcelable Creator for GetValueResult.