MozMobileConnection.setCardLock()

This API is available on Firefox OS for internal applications only.

Summary

The setCardLock method is used to set or modify the state of a card lock.

Note: If the setCardLock call fails the icccardlockerror event is fired.

Syntax

JavaScript
var request = navigator.mozMobileConnection.setCardLock(info);

Parameters

info

An object containing information about the lock and how to modify its state. At a minimum, this object must have a lockType property which specifies the type of lock, e.g., "pin" for the PIN lock. Other properties are dependent on the lock type:

Object for enabling/disabling the PIN lock:

JavaScript
{
  lockType: "pin",
  pin     : "...", // The current pin number
  enabled : false  // false to unlock, true to lock
}

Object for enabling/disabling the FDN lock:

JavaScript
{
  lockType: "fdn",
  pin2    : "...", // The secondary pin number
  enabled : false  // false to unlock, true to lock
}

Object for changing the PIN:

JavaScript
{
  lockType: "pin",
  pin     : "...", // The current pin number
  newPin  : "..."  // The new pin number
}

Object for changing the PIN2:

JavaScript
{
  lockType: "pin2",
  pin     : "...", // The current secondary pin number
  newPin  : "..."  // The new secondary pin number
}

Return

A DOMRequest object to handle the success or error of the method call.

The request's result will be an object containing information about the operation:

The resulting object if enabling/disabling the card lock failed or change card lock failed:

JavaScript
{
  lockType  : "pin", // Can be "pin", "pin2" or "fdn"
  success   : false,
  retryCount: 2
}

The resulting object if enabling/disabling the card lock succeeded or change card lock succeeded:

JavaScript
{
  lockType: "pin", // Can be "pin", "pin2" or "fdn"
  success : true
}

Specification

Not part of any specification.

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/mozmobileconnection/setcardlock

API B2G Firefox OS Method Reference Référence