VideoSMS/Client Application Programming Interface ... - MCTel

VIDEOSMS SMS Management Functions (outside Premium session)SMS_GetMessageSMS_GetMessage—SMS-MO or transmissionacknowledgement receptionThis function is used to get either incoming SMS-MO or transmissionacknowledgements in real time.FORMAT SMS_GetMessage UInt32 *ConnectId, SMSMessage*Message_receivedRETURNSVMS Usage: cond_valuestype: entier longaccess: lecture seulemechanism: par valeurARGUMENTSConnectIdVMS Usage: pointertype: pointer to longwordaccess: read onlymechanism: by referenceUnique connection id, initialized by the function SMS_ConnectGateway.*Message_receivedVMS Usage: pointertype: pointer to SMSMessage structureaccess: writemechanism: by referencePointer to a SMSMessage structure type.DESCRIPTIONThis routing allows the application to receive on real time incoming SMS-MO and transmission acknowledgements for SMS-MT either previouslysent or sent by a separate thread.If no SMS-MO or transmission acknowledgement is pending for thisaccount, the function will wait and will only return the control to thecalling program when one is received or the link is lost. The SMS_GetMessage will take charge of maintaining the link by transmitting SMS_EnquireLink at regular intervals (to avoid to get disconnected on timeoutby the SMS Gateway).The calling application will have to look at the message_type field ofthe SMSMessage structure to know if it is an incoming SMS-MO or atransmission acknowledgement regarding a previously submitted SMS-MT.5–15