gtpc2miu | C/C++ Language Support User's Guide |
This function is called to position the external device to the requested location based on the information returned from a previous TPFxd_open or TPFxd_getPosition request.
Format
#include <c$tpxd.h> long TPFxd_setPosition (TPFxd_extToken *token, TPFxd_location *positioningString)
Normal Return
A return code of 1 indicates a normal return.
Error Return
An error return is indicated by a negative return code. For a list of error codes applicable to this function, see Error Codes.
Programming Considerations
Examples
The following example issues a TPFxd_archiveStart and then a TPFxd_open request, and later repositions the device to the point of the TPFxd_open request.
#include <c$tpxd.h> long example() { TPFxd_extToken *token; TPFxd_locationMap wherefirst; TPFxd_location wherenow; enum tpxd_mode mode; long howbigitis; long howlongtowait; char *message; long returncode; howlongtowait = 60; howbigitis = 32000; message = NULL; mode = WT; TPFxd_archiveStart (&token, mode, access); returncode = TPFxd_open (&token, &wherefirst, howbigitis, howlongtowait, message, mode );
·
·
·
returncode = TPFxd_getPosition (token, &wherenow);
·
·
·
returncode = TPFxd_setPosition (token, &wherenow); printf("setPosition complete with return code %i\n",returncode); }
Related Information