VideoSMS/Client Application Programming Interface ... - MCTel

Other Network FunctionsSMS_GetLocationSMS_GetLocation—Location positioning requestThis function request the geographical location positioning of a given mobileuser.FORMAT SMS_GetLocation UInt32 *ConnectId, *UserLocationRETURNSVMS Usage: cond_valuestype: longwordaccess: read onlymechanism: by valueARGUMENTSConnectIdVMS Usage: pointertype: pointer to longwordaccess: read onlymechanism: by referenceUnique connection id, initialized by the function SMS_ConnectGateway.MobileMSISDNVMS Usage: pointertype: pointer to stringaccess: read onlymechanism: by referenceMobile MSISDN to locate in international format.*UserLocationVMS Usage: pointertype: pointer to a SMSUserLocation structure typeaccess: write onlymechanism: by referencePointer to a SMSUserLocation type structure.DESCRIPTIONThis function query the mobile network operator to request the currentor last known user geographical location. It is possible the specify themobile MSISDN, if not specified the request will apply to the currentlyopen Premium SMS session.This function returns the success or failure status and in case of successwill return the geographical location positioning in the UserLocationstructure. The last known date of this structure must be checked toensure the accuracy of the returned location.The request may fail if the user or the network does not allow the locationpositioning operation of if the SMS Gateway is not allowed to perform thisrequest.6–2