Collapse all Symbian^3 Application Developer Library

MAuthenticationObjectList Class Reference

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 &)

Member Functions Documentation

CancelList()

void

CancelList

(

)

[pure virtual]

Cancels an asynchronous List() operation.

The operation completes with KErrCancel.

List(RMPointerArray< MCTAuthenticationObject > &, TRequestStatus &)

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.

Parameters

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.