38 * @lib bteng*.lib |
38 * @lib bteng*.lib |
39 * @since S60 v3.2 |
39 * @since S60 v3.2 |
40 */ |
40 */ |
41 class MBTEngActiveObserver |
41 class MBTEngActiveObserver |
42 { |
42 { |
43 |
|
44 public: |
43 public: |
45 |
44 |
46 /** |
45 /** |
47 * Callback to notify that an outstanding request has completed. |
46 * Callback to notify that an outstanding request has completed. |
48 * |
47 * |
49 * @since S60 v3.2 |
48 * @since S60 v3.2 |
50 * @param aActive Pointer to the active object that completed. |
49 * @param aActive Pointer to the active object that completed. |
|
50 * @param aStatus The status of the completed request. |
|
51 */ |
|
52 virtual void RequestCompletedL( CBTEngActive* aActive, TInt aStatus ) = 0; |
|
53 |
|
54 /** |
|
55 * Callback for handling cancelation of an outstanding request. |
|
56 * |
|
57 * @since Symbian^4 |
51 * @param aId The ID that identifies the outstanding request. |
58 * @param aId The ID that identifies the outstanding request. |
52 * @param aStatus The status of the completed request. |
59 */ |
53 */ |
60 virtual void CancelRequest( TInt aRequestId ) = 0; |
54 virtual void RequestCompletedL( CBTEngActive* aActive, TInt aId, |
|
55 TInt aStatus ) = 0; |
|
56 |
61 |
57 /** |
62 /** |
58 * Callback to notify that an error has occurred in RunL. |
63 * Callback to notify that an error has occurred in RunL. |
59 * |
64 * |
60 * @param aActive Pointer to the active object that completed. |
65 * @param aActive Pointer to the active object that completed. |
61 * @param aId The ID that identifies the outstanding request. |
66 * @param aError The error occurred in RunL. |
62 * @param aStatus The status of the completed request. |
67 */ |
63 */ |
68 virtual void HandleError( CBTEngActive* aActive, TInt aError ) = 0; |
64 virtual void HandleError( CBTEngActive* aActive, TInt aId, |
|
65 TInt aError ) = 0; |
|
66 |
|
67 }; |
69 }; |
68 |
|
69 |
70 |
70 /** |
71 /** |
71 * Class CBTEngActive |
72 * Class CBTEngActive |
72 * |
73 * |
73 * ?more_complete_description |
74 * ?more_complete_description |
120 * @since S60 v3.2 |
121 * @since S60 v3.2 |
121 */ |
122 */ |
122 inline void GoActive(); |
123 inline void GoActive(); |
123 |
124 |
124 /** |
125 /** |
125 * Cancel an outstanding request. |
|
126 * |
|
127 * @since S60 v3.2 |
|
128 */ |
|
129 inline void CancelRequest(); |
|
130 |
|
131 /** |
|
132 * Get a reference to the active object request status. |
126 * Get a reference to the active object request status. |
133 * |
127 * |
134 * @since S60 v3.2 |
128 * @since S60 v3.2 |
135 * @return Reference to the active object request status. |
129 * @return Reference to the active object request status. |
136 */ |
130 */ |
137 TRequestStatus& RequestStatus(); |
131 TRequestStatus& RequestStatus(); |
138 |
132 |
|
133 private: |
139 // from base class CActive |
134 // from base class CActive |
140 |
135 |
141 /** |
136 /** |
142 * From CActive. |
137 * From CActive. |
143 * Called by the active scheduler when the request has been cancelled. |
138 * Called by the active scheduler when the request has been cancelled. |