MozMobileConnection.unlockCardLock()

Non-standard
This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

Summary

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

Syntax

var request = navigator.mozMobileConnection.unlockCardLock(info);

Parameters

info

An object containing information to unlock the given lock. 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 unlocking the PIN:

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

Object for unlocking the network control key (NCK) :

{
lockType: "nck",
pin : "..." // The current pin number
}

Object for unlocking the PUK and supplying a new PIN:

{
lockType: "puk",
puk : "...",
newPin : "..."
}

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: