diff -r 48780e181b38 -r 578be2adaf3e Symbian3/PDK/Source/GUID-12A7A518-CA65-5019-B3D1-F11C9EFE201F.dita --- a/Symbian3/PDK/Source/GUID-12A7A518-CA65-5019-B3D1-F11C9EFE201F.dita Tue Jul 20 12:00:49 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-12A7A518-CA65-5019-B3D1-F11C9EFE201F.dita Fri Aug 13 16:47:46 2010 +0100 @@ -1,57 +1,57 @@ - - - - - -Phone -Identity TutorialThis tutorial describes how to identify a phone using multimode -phone sub-sessions. Phone identity information are the phone manufacturer, -model, revision, serial number and subscriber ID. -

The serial number is called the IMEI for GSM and ESN for non-GSM. -The -subscriber ID is a unique number called the IMSI. -

 - - - - -Check if the identity -information can be obtained using RMobilePhone::GetIdentityCaps(). -Capabilities are described by RMobilePhone::TMobilePhoneIdentityCaps. - -Retrieve the identity -information using RMobilePhone::GetPhoneId(). -Phone identity information is returned in a RMobilePhone::TMobilePhoneIdentityV1 object. -This function does not return the subscriber ID. - -Retrieve the subscriber -ID using anRMobilePhone::GetSubscriberId(). -A subscriber ID is described in an RMobilePhone::TMobilePhoneSubscriberId buffer. - - -

The function returns the information to identify the device.

-Phone identity example

The following code checks -if phone model information can be obtained, and if so, gets the model information. -The code assumes iMobilePhone is an RMobilePhone object.

-TUint32 identityCaps; - -User::LeaveIfError(iMobilePhone.GetIdentityCaps(identityCaps)); -TBuf<RMobilePhone::KPhoneModelIdSize> model; - -if (identityCaps & RMobilePhone::KCapsGetModel) - { - TRequestStatus status; - RMobilePhone::TMobilePhoneIdentityV1 mobilePhoneIdentity; - iMobilePhone.GetPhoneId(status, mobilePhoneIdentity); - User::WaitForRequest(status); - User::LeaveIfError(status.Int()); - model = mobilePhoneIdentity.iModel; - } - + + + + + +Phone +Identity TutorialThis tutorial describes how to identify a phone using multimode +phone sub-sessions. Phone identity information are the phone manufacturer, +model, revision, serial number and subscriber ID. +

The serial number is called the IMEI for GSM and ESN for non-GSM. +The +subscriber ID is a unique number called the IMSI. +

 + + + + +Check if the identity +information can be obtained using RMobilePhone::GetIdentityCaps(). +Capabilities are described by RMobilePhone::TMobilePhoneIdentityCaps. + +Retrieve the identity +information using RMobilePhone::GetPhoneId(). +Phone identity information is returned in a RMobilePhone::TMobilePhoneIdentityV1 object. +This function does not return the subscriber ID. + +Retrieve the subscriber +ID using anRMobilePhone::GetSubscriberId(). +A subscriber ID is described in an RMobilePhone::TMobilePhoneSubscriberId buffer. + + +

The function returns the information to identify the device.

+Phone identity example

The following code checks +if phone model information can be obtained, and if so, gets the model information. +The code assumes iMobilePhone is an RMobilePhone object.

+TUint32 identityCaps; + +User::LeaveIfError(iMobilePhone.GetIdentityCaps(identityCaps)); +TBuf<RMobilePhone::KPhoneModelIdSize> model; + +if (identityCaps & RMobilePhone::KCapsGetModel) + { + TRequestStatus status; + RMobilePhone::TMobilePhoneIdentityV1 mobilePhoneIdentity; + iMobilePhone.GetPhoneId(status, mobilePhoneIdentity); + User::WaitForRequest(status); + User::LeaveIfError(status.Int()); + model = mobilePhoneIdentity.iModel; + } + \ No newline at end of file