© Nokia 2006
|
S60 3rd Edition SDK for Symbian OS Example Applications Guide |
00001 /* 00002 * ============================================================================ 00003 * Name : IsvTelCallAppTelephonyNotify.h 00004 * Part of : IsvTelCallApp 00005 * Interface : 00006 * Description : An interface class is notified when an async telephony command 00007 * execution is completed. 00008 * Version : 00009 * 00010 * Copyright (c) 2005-2006 Nokia Corporation. 00011 * This material, including documentation and any related 00012 * computer programs, is protected by copyright controlled by 00013 * Nokia Corporation. 00014 * ============================================================================ 00015 */ 00016 00017 #ifndef ISVTELCALLAPP_TELEPHONY_NOTIFY_H 00018 #define ISVTELCALLAPP_TELEPHONY_NOTIFY_H 00019 00020 //INCLUDES 00021 #include <etel3rdparty.h> 00022 00023 //CLASS DEFINITIONS 00024 /** 00025 * MIsvTelCallAppTelephonyNotify: This class specifies an interface that should 00026 * be implemented by a class if it wants to get notified on completion of async 00027 * telephony commands 00028 */ 00029 class MIsvTelCallAppTelephonyNotify 00030 { 00031 public: 00032 /** 00033 * Pure virtual functions 00034 */ 00035 00036 /** 00037 * Gets invoked once command completion notification from DialNewCall 00038 * ETel API is received. 00039 * @param aStatus, specifies SUCCESS or Error code 00040 * @param aCallId, refrence to Call ID. 00041 * @param aTelNum, refrence to Tel Number. 00042 * @param aErrMsg, contains the error message returned by ETel API 00043 */ 00044 virtual void MakeNewCallApiCompleteL( TInt aStatus, 00045 const CTelephony::TCallId aCallId, 00046 CTelephony::TTelNumber &aTelNum, 00047 TDesC16& aErrMsg ) = 0; 00048 00049 /** 00050 * Gets invoked once command completion notification from HangUp 00051 * ETel API is received. 00052 * @param aStatus, specifies SUCCESS or Error code 00053 * @param reference to Call ID. 00054 * @param aErrMsg, contains the error message returned by ETel API 00055 */ 00056 virtual void HangupCompleteL( TInt aStatus, TDesC16& aErrMsg ) = 0; 00057 00058 /** 00059 * Gets invoked once command completion notification from Hold 00060 * ETel API is received. 00061 * @param aStatus, specifies SUCCESS or Error code 00062 * @param aCallId, refrence to Call ID. 00063 * @param aErrMsg, contains the error message returned by ETel API 00064 */ 00065 virtual void HoldCompleteL(TInt aStatus, TDesC16& aErrMsg ) = 0; 00066 00067 /** 00068 * Gets invoked once command completion notification from Resume 00069 * ETel API is received. 00070 * @param aStatus, specifies SUCCESS or Error code 00071 * @param aCallId, refrence to Call ID. 00072 * @param aErrMsg, contains the error message returned by ETel API 00073 */ 00074 virtual void ResumeCompleteL( TInt aStatus, TDesC16& aErrMsg ) = 0; 00075 00076 /** 00077 * Gets invoked once command completion notification from Swap 00078 * ETel API is received. 00079 * @param aStatus, specifies SUCCESS or Error code 00080 * @param aErrMsg, contains the error message returned by ETel API 00081 */ 00082 virtual void SwapCompleteL( TInt aStatus, TDesC16& aErrMsg) = 0; 00083 00084 00085 /** 00086 * Gets invoked once command completion notification from GetCallStatus 00087 * ETel API is received. 00088 * @param aStatus, specifies SUCCESS or Error code 00089 * @param aCallId, refrence to Call ID. 00090 * @param aCallStatus, contains status 00091 * @param aErrMsg, contains the error message returned by ETel API 00092 */ 00093 virtual void GetCallStatusCompleteL( TInt aStatus, 00094 const CTelephony::TCallId aCallId, 00095 CTelephony::TCallStatusV1& aCallStatus, 00096 TDesC16& aErrMsg ) = 0; 00097 00098 /** 00099 * Gets invoked once command completion notification from 00100 * GetLineStatus ETel API is received. 00101 * @param aStatus, specifies SUCCESS or Error code 00102 * @param aErrMsg, contains the error message returned by ETel API 00103 * @param aCallStatus, contains status. 00104 */ 00105 virtual void GetVoiceLineStatusCompleteL( 00106 TInt aStatus, 00107 TDesC16& aErrMsg, 00108 CTelephony::TCallStatusV1& aCallStatus ) = 0; 00109 00110 /** 00111 * Gets invoked once command completion notification from 00112 * GetLineStatus ETel API is received. 00113 * @param aStatus, specifies SUCCESS or Error code 00114 * @param aErrMsg, contains the error message returned by ETel API 00115 * @param aCallStatus, contains status. 00116 */ 00117 virtual void GetDataLineStatusCompleteL( 00118 TInt aStatus, 00119 TDesC16& aErrMsg, 00120 CTelephony::TCallStatusV1& aCallStatus ) = 0; 00121 00122 /** 00123 * Gets invoked once command completion notification from 00124 * GetLineStatus ETel API is received. 00125 * @param aStatus, specifies SUCCESS or Error code 00126 * @param aErrMsg, contains the error message returned by ETel API 00127 * @param aCallStatus, contains status. 00128 */ 00129 virtual void GetFaxLineStatusCompleteL( 00130 TInt aStatus, 00131 TDesC16& aErrMsg, 00132 CTelephony::TCallStatusV1& aCallStatus ) = 0; 00133 00134 /** 00135 * Gets invoked once command completion notification from 00136 * SendDTMFTones ETel API is received. 00137 * @param aStatus, specifies SUCCESS or Error code 00138 * @param aErrMsg, contains the error message returned by ETel API 00139 */ 00140 virtual void SendDTMFApiCompleteL( TInt aStatus, 00141 TDesC16& aErrMsg ) = 0; 00142 00143 /** 00144 * Gets invoked once command completion notification from 00145 * AnswerIncomingCallApiCompleteL ETel ISV API is received. 00146 * @param aStatus, specifies SUCCESS or Error Code 00147 * @param aErrMsg, contains the error message returned by ETel ISV API 00148 */ 00149 virtual void AnswerIncomingCallApiCompleteL( TInt aStatus, 00150 const CTelephony::TCallId aCallId, 00151 TDesC16& aErrMsg ) = 0; 00152 }; 00153 00154 #endif // ISVTELCALLAPP_TELEPHONY_NOTIFY_H 00155 00156 //End of file
|
© Nokia 2006 |
|