VideoSMS/Client Application Programming Interface ... - MCTel

Premium SMS Session Management FunctionsSMS_ReadSMS_Read—Read incoming SMS receivedThis function is used to read an incoming SMS-MO received by the gatewayand destined to the application.FORMAT SMS_Read UInt32 *ConnectId, *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 a SMSMessage type structureaccess: write onlymechanism: by referencePointer to a SMSMessage type structure.DESCRIPTIONThis function is used by the application to get a SMS-MO request sentfrom a remote mobile user to this application.This function must be called first to initialize the session context.If no message has been received for this application, the SMSNoMessage isreturned. This application must then either disconnect and connect againlater, or issue another SMS_Read request at regular intervals.RETURNSTATUSSMSNormalSMSNoMessageSMSNotConnectedSMSNotAuthentifieda SMS-MO message for this application has beenreceived by the gateway and is returned in theMessage_received structure.no received message for this application.the system is not connected to the SMS Gateway.the application is not authentified on the SMSgateway.7–2