*
* @code
*
- * result
- * MyClass::GetNetworkManagerInfo(void)
- * {
- * NetworkStatus networkStatus;
- * NetworkInfo networkInfo;
+ * #include <FBase.h>
+ * #include <FTelephony.h>
*
- * NetworkManager* pNetworkManager = new NetworkManager();
+ * using namespace Tizen::Base;
+ * using namespace Tizen::Telephony;
*
- * result r = pNetworkManager->Construct(this);
- * if (IsFailed(r))
- * {
- * delete pNetworkManager;
- * return r;
- * }
+ * class MyClass
+ * : public Object
+ * , public ITelephonyNetworkEventListener
+ * {
+ * public:
+ * MyClass(void) {}
+ * ~MyClass(void) {}
*
- * r = pNetworkManager->GetNetworkStatus(networkStatus);
- * if (IsFailed(r))
- * {
- * delete pNetworkManager;
- * return r;
- * }
+ * // ITelephonyNetworkEventListener
+ * void OnTelephonyNetworkStatusChanged(const NetworkStatus& networkStatus);
*
- * r = pNetworkManager->GetNetworkInfo(networkInfo);
- * if (IsFailed(r))
- * {
- * delete pNetworkManager;
- * return r;
- * }
+ * void GetNetworkManagerInfo(void);
+ * };
*
- * delete pNetworkManager;
- * return E_SUCCESS;
- * }
+ * void
+ * MyClass::OnTelephonyNetworkStatusChanged(const NetworkStatus& networkStatus)
+ * {
+ * bool isCallAvailable = networkStatus.IsCallServiceAvailable();
+ * bool isDataAvailable = networkStatus.IsDataServiceAvailable();
+ * bool isRoaming = networkStatus.IsRoaming();
+ * }
*
- * void
- * MyClass::OnTelephonyNetworkStatusChanged(const NetworkStatus& networkStatus)
- * {
- * bool isCallAvail = networkStatus.IsCallServiceAvailable();
- * bool isDataAvail = networkStatus.IsDataServiceAvailable();
- * bool isRoaming = networkStatus.IsRoaming();
- * }
+ * void
+ * MyClass::GetNetworkManagerInfo(void)
+ * {
+ * NetworkStatus networkStatus;
+ * NetworkInfo networkInfo;
+ *
+ * NetworkManager* pNetworkManager = new (std::nothrow) NetworkManager();
+ * result r = pNetworkManager->Construct(this);
+ * if (IsFailed(r))
+ * {
+ * delete pNetworkManager;
+ * return;
+ * }
+ *
+ * r = pNetworkManager->GetNetworkStatus(networkStatus);
+ * if (IsFailed(r))
+ * {
+ * delete pNetworkManager;
+ * return;
+ * }
+ *
+ * r = pNetworkManager->GetNetworkInfo(networkInfo);
+ * if (IsFailed(r))
+ * {
+ * delete pNetworkManager;
+ * return;
+ * }
+ *
+ * delete pNetworkManager;
+ * }
*
* @endcode
*/
* is no listener for telephony network status change callbacks.
*
* @since 2.0
- *
+ * @feature %http://tizen.org/feature/network.telephony
* @return An error code
* @param[in] pListener The listener for change in status of a telephony network
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
+ * @remarks Before calling this method, check whether the feature is supported by
+ * Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
*/
result Construct(ITelephonyNetworkEventListener* pListener);
* Gets the network status.
*
* @since 2.0
- * @privilege %http://tizen.org/privilege/systeminfo
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/telephony @n
+ * (%http://tizen.org/privilege/systeminfo is deprecated.)
*
* @return An error code
* @param[out] networkStatus The network status
* Gets the network information.
*
* @since 2.0
- * @privilege %http://tizen.org/privilege/systeminfo
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/telephony @n
+ * (%http://tizen.org/privilege/systeminfo is deprecated.)
*
* @return An error code
* @param[out] networkInfo The network information
result GetNetworkInfo(NetworkInfo& networkInfo) const;
/**
- * @if VISPARTNER-MANUFACTURER
* Sets the listener for receiving the responses of the search network and the network selection mode.
*
* @since 2.0
*
- * @visibility partner-manufacturer
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/telephonymanager
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- *
- * @endif
*/
result SetNetworkSettingListener(ITelephonyNetworkSettingListener* pListener);
/**
- * @if VISPARTNER-MANUFACTURER
* Gets the network selection mode.
*
* @since 2.0
*
- * @visibility partner-manufacturer
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/telephonymanager
*
* @return An error code
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @see ITelephonyNetworkSettingListener::OnTelephonyNetworkSelectionModeReceived()
- *
- * @endif
*/
result GetNetworkSelectionMode(void);
/**
- * @if VISPARTNER-MANUFACTURER
* Selects the manually searched network.
*
* @since 2.0
*
- * @visibility partner-manufacturer
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/telephonymanager
*
* @return An error code
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @see ITelephonyNetworkSettingListener::OnTelephonyNetworkSelectionCompleted()
- *
- * @endif
*/
result SelectNetwork(const NetworkInfo& networkInfo);
/**
- * @if VISPARTNER-MANUFACTURER
* Selects the network automatically.
*
* @since 2.0
*
- * @visibility partner-manufacturer
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/telephonymanager
*
* @return An error code
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @see ITelephonyNetworkSettingListener::OnTelephonyNetworkSelectionCompleted()
- *
- * @endif
*/
result SelectNetwork(void);
/**
- * @if VISPARTNER-MANUFACTURER
* Searches for an available network.
*
* @since 2.0
*
- * @visibility partner-manufacturer
+ * @privlevel platform
* @privilege %http://tizen.org/privilege/telephonymanager
*
* @return An error code
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @see ITelephonyNetworkSettingListener::OnTelephonyNetworkSearchCompletedN()
- *
- * @endif
*/
result SearchNetwork(void);