It defines dial interface for phone client.

Usage:

To dial, you must have a string of characters from set { 0, 1, 2, .. 9, #, *, +, p, P, w, W }. It is the only mandatory parameter. String may also contain other characters, but then only a note is displayed. So you should proceed as follows: 1. Check that string is acceptable. (application specific grammar) 2. If not, stop. Otherwise continue. 3. Convert to string acceptable by phoneclient. Note PhCltUtils class may help. 4. Dial using the class.

Note that dialling does not always mean creating a call. (E.g. *#43# makes phone to interrogate status of call waiting.)

In order to dial, you need instance of CPhCltExtPhoneBase . You can create one as follows: iExtCall = CPhCltExtPhoneBase::NewL( this ); (the parameter is pointer to observer)

Then you must fill dial parameters to instance of TPhCltExtPhoneDialData. (you can read more details from its header)

TPhCltExtPhoneDialData data; data.SetTelephoneNumber( .. ); ..

And finally, you can dial. Note that the method is asynchronous and observer will be informed when phone starts dialing.

iExtCall->DialL( data );

Finally, you can delete the instance. If dialing is ongoing, this should be done after observer has been informed. You can also delete before that, but then the request might also be canceled.