| class MAuthenticationObjectList |
An interface that enables clients to list all the authentication objects on a token, find out which objects they protect, and change/unblock/enable/disable them.
It may be used to implement a 'PIN manager' control panel item. This could list the PINs (by label), allow one to be selected, list what it is used for (including information such as what operations on that object are protected by that PIN), and then allow the user to change, enable, disable, and unblock the PIN.
Note that no PINs appear anywhere in this API. The code implementing this API will display a PIN dialog via the secure dialog interface when a PIN is required. The main advantage of this is that if some hostile code were to capture a PIN, it couldn't do anything with it as none of the APIs take a PIN. A secondary benefit is that the same API can work with biometrics or other methods of authentication.
| Public Member Functions | |
|---|---|
| void | CancelList() |
| void | List(RMPointerArray< MCTAuthenticationObject > &, TRequestStatus &) |
| void | CancelList | ( | ) | [pure virtual] |
Cancels an asynchronous List() operation.
The operation completes with KErrCancel.
| void | List | ( | RMPointerArray< MCTAuthenticationObject > & | aAuthObjects, |
| TRequestStatus & | aStatus | |||
| ) | [pure virtual] | |||
Gets a list of all the authenticaiton objects in the token.
This is an asynchronous request.
| RMPointerArray< MCTAuthenticationObject > & aAuthObjects | On return, a list of all the authentication objects. |
| TRequestStatus & aStatus | The request status object; contains the result of the List() request when complete. Set to KErrCancel if an outstanding request is cancelled. |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.