gtpc2miuC/C++ Language Support User's Guide

TPFxd_setPosition-Set Current Position of the External Device

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)

token
The returned token from the TPFxd_archiveStart or TPFxd_open request.

positioningString
The returned positioning string from a TPFxd_getPosition function call or the following keyword string:

First
The position to the first data record on the external device.

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