VideoSMS/Client Application Programming Interface ... - MCTel

Management functionsSMS_GetProcessedMessage• 0: full data: in this case the whole message details are retrievedand returned. If this bit is not set and in order to increase networkperformance, only the following data will be returned:5 msg_reference_number: message reference number5 called_number: called number5 caller_number: caller number5 sms_state: message state5 sms_error: transmission error code if applicable.5 posted_date: SMS submission date.5 transmitted_date: SMS reception date or final error date.• 1: get next: if this bit is set and the function has been called previously,the function will return either the next message in the log or an error ifthere is no more message. The previous SMS_GetProcessedMessagefunction call must have been called with the bit 2 of the msgoptions fieldset.• 2: expect next: if a message is retrieved, the calling program will performanother request with bit 1 set (get next option). The bit 2 will ask thegateway to keep the search context.• 3: return also charging data: if this bit is set, the function will also returnthe charging information regarding this message: charge, credit or otheroperation.*SMSMessageVMS Usage: pointertype: pointer to a SMSMessage structureaccess: write onlymechanism: by referencePointer to a SMSMessage structure returning the complete message data (ifbit 0 full data is set).DESCRIPTIONThis function retrieve and returns all incoming or outgoing messagesprocessed by the user or application. There is no need to know the messagereference numbers to retrieve them. This function must be called afterprevious user identification.RETURNVALUESSMSNormalSMSNoMessageSMSNoPrivilegeSMSErrorSMSLinkLostSMSNoVideosmsa message has been found and is returned.no more message found.user access rights could not grant access to thisfunction.an error occured.the link with the remote SMS gateway has been lost.VIDEOSMS is not installed on this system.8–15