All Classes Functions Variables Typedefs Friends Pages
Public Member Functions | List of all members
Glympse::ISmsProvider Struct Referenceabstract

Provides access to generic SMS auto-send functionality. More...

#include <ISmsProvider.h>

Inheritance diagram for Glympse::ISmsProvider:
Inheritance graph
[legend]

Public Member Functions

virtual int32 canDeviceSendSms ()=0
 This method should be used to determine, whether SMS functionality is available on specific devide at the moment. More...
 
virtual bool sendSms (const GString &address, const GString &message, const GSmsListener &listener)=0
 Sends SMS message. More...
 
- Public Member Functions inherited from Glympse::ICommon
virtual int32 retain ()=0
 Add a reference to our object in a COM-like way.
 
virtual int32 release ()=0
 Release a reference to our object in a COM-like way.
 
virtual int32 hold ()=0
 Add a reference to our object in a COM-like way.
 
virtual int32 unhold ()=0
 Release a reference to our object in a COM-like way.
 
virtual int32 hashCode ()=0
 Returns an integer hash code for this object.
 
virtual bool equals (const GCommonObj &o)=0
 Compares this instance with the specified object and indicates if they are equal. More...
 
virtual GString toString ()=0
 Returns a string containing a concise, human-readable description of this object. More...
 
virtual void attachObject (const GCommon &obj)=0
 Asociates arbitrary object with the instance.
 
virtual GCommon extractObject ()=0
 Extracts associated object or NULL if no association is established.
 

Additional Inherited Members

- Protected Member Functions inherited from Glympse::ICommon
virtual ~ICommon ()
 Destructor is protected to deny explicit object deallocation. More...
 

Detailed Description

Provides access to generic SMS auto-send functionality.

Current implementation of SMS provider is not thread safe. It is only allowed to invoke sendSMS method from main application thread.

Member Function Documentation

virtual int32 Glympse::ISmsProvider::canDeviceSendSms ( )
pure virtual

This method should be used to determine, whether SMS functionality is available on specific devide at the moment.

Currently returns GC::SMS_SEND_AUTO on iOS 4.x and 5.x, which means that all SMS messages are sent in autimatic mode. No UI is presented and no additional programmatic handling on application side is required.

Returns GC::SMS_SEND_NOT_SUPPORTED, if the feature is temporarily or permanently (iPod, iPad, iOS 6.0 or above) unavailable.

See GlympseConstants for more details.

virtual bool Glympse::ISmsProvider::sendSms ( const GString address,
const GString message,
const GSmsListener listener 
)
pure virtual

Sends SMS message.

Queuing SMS delivery requests is supported. Messages are sent in the order of appending to the queue.

Parameters
addressRecipient phone number.
messageMessage body.
listenerReference to an object implementing ISmsListener interface.
Returns
Returns true, if SMS message is scheduled for delivery. false is returned if one of method arguments (address or message) is incorrect.

The documentation for this struct was generated from the following file: