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.

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

TCTTokenHandle ( const TCTTokenHandle & )

IMPORT_CTCTTokenHandle(const TCTTokenHandle &aTokenHandle)

The copy constructor.

ParameterDescription
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.

ParameterDescription
aTokenHandleThe Token Handle object to be compared.

Returns: 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.

ParameterDescription
aTokenHandleThe Token Handle object to be compared.

Returns: ETrue, if this Token Handle object is equal to the specified Token Handle object; EFalse otherwise.