View source

{{KBTS}}
__NOTOC__ 
__NOEDITSECTION__

[[Category:Technical Solution]]

{{KnowledgeBase
|id=TSS000374
|platform=S60 3rd Edition
|devices=
|category=Symbian C<nowiki>++</nowiki>
|subcategory=
|creationdate=July 7, 2006
|keywords=
}}

== Overview ==
Method User::WaitForRequest() is used with the ETel 3rd Party API (CTelephony)

== Description ==
The ETel 3rd Party API (that is, CTelephony) was designed to be used in asynchronous mode, with its methods called from an active object that is then going to wait for the method to complete. As an active object can have, by definition, only one active request at a time, the asynchronous methods of Telephony are designed to panic (with "Telephony 0") whenever it is detected during a method call that the TRequestStatus parameter passed to this method (in fact, the iStatus member of CActive) is already set to KRequestPending.<br>A common (although not recommended) practice among Symbian developers is to "synchronize" the asynchronous method calls with the User::WaitForRequest to block the thread until the operation completes.<br>There are two major problems with this approach:<br>- The asynchronous call can take a long time until it completes and keeping the thread blocked for the entire time can cause a VIEWSERV 11 panic (see Symbian<nowiki>’</nowiki>s FAQ-0920).<br>&nbsp;- The asynchronous method may be implemented using other active objects and asynchronous methods running on the same thread. If so, the methods can never complete since the thread is blocked and as such, the thread will remain blocked forever.<br>In a concrete case of CTelephony and considering the following code example:<br>CTelephony::TBatteryInfoV1 batterystrength;<br>CTelephony::TBatteryInfoV1Pckg battery(batterystrength);<br>CTelephony* tel = CTelephony::NewLC();<br>TRequestStatus status = KRequestPending; // (1)<br>tel-<nowiki>></nowiki>GetBatteryInfo(status, battery);<br>User::WaitForRequest(myStat); // (2)<br>...<br>CleanupStack::PopAndDestroy();<br>This means:<br>- The TRequestStatus variable is initialized with KRequestPending - line &nbsp;(1) &nbsp;- a very common mistake that usually does not affect the API calls except that with CTelephony it will cause the "Telephony 0" panic as described above. Please note that a TRequestStatus variable should, in general, not be initialized.<br>- Assuming that the initialization from (1) is removed, the code will never return from line (2) as CTelephony<nowiki>’</nowiki>s asynchronous methods cannot complete while the thread is blocked.<br>In conclusion, CTelephony must always be used asynchronously, from within an active object. Moreover, User::WaitForRequest must be used with caution.

[[Category:Symbian C++]][[Category:S60 3rd Edition]]