TCTTokenHandle Class Reference

#include <ct/tcttokenhandle.h>

Link against: ctframework.lib

class TCTTokenHandle

Detailed Description

Defines a handle to a subclass of the MCTToken class.

The handle identifies the class, not a particular instance of that class. It is guaranteed to be unique within the context of a specific device (e.g. mobile phone, etc.).

The handle is especially useful for communication across process boundaries. For example: a process (A) can open a token (T), get a handle to it and then give the handle to another process (B). This process (B) can then try to open the token (T) using that handle.

Since
v7.0

Member Attribute Documentation

iTokenId

TInt iTokenId

The identity of the Token.

This Id is unique within the context of a TokenType.

iTokenTypeUid

TUid iTokenTypeUid

The UID of the TokenType.

This identifies to which TokenType the Token belongs.

Constructor & Destructor Documentation

TCTTokenHandle ( )

IMPORT_CTCTTokenHandle()

Creates an invalid handle for the token.

An invalid handle has a iTokenTypeUid and a iTokenId equal to 0.

TCTTokenHandle ( TUid, TInt )

IMPORT_CTCTTokenHandle(TUidaTokenTypeUid,
TIntaTokenId
)

Creates a handle for the token.

Parameters
aTokenTypeUidThe value of the TokenType Uid.
aTokenIdThe identity of the Token.

TCTTokenHandle ( const TCTTokenHandle & )

IMPORT_CTCTTokenHandle(const TCTTokenHandle &aTokenHandle)

The copy constructor.

Parameters
aTokenHandleThe Token Handle object to copy

Member Function Documentation

operator!= ( const TCTTokenHandle & )

TBool operator!=(const TCTTokenHandle &aTokenHandle)const [inline]

Inequality operator.

Tests whether this Token Handle object is not equal to the specified Token Handle object.

Parameters
aTokenHandleThe Token Handle object to be compared.
Return Value
ETrue, if this Token Handle object is not equal to the specified Token Handle object; EFalse, otherwise.

operator== ( const TCTTokenHandle & )

IMPORT_C TBooloperator==(const TCTTokenHandle &aTokenHandle)const

Equality operator.

Tests whether this Token Handle object is equal to the specified Token Handle object.

Parameters
aTokenHandleThe Token Handle object to be compared.
Return Value
ETrue, if this Token Handle object is equal to the specified Token Handle object; EFalse otherwise.