Download CIMPLICITY HMI Tracking Operation Manual

prt_api_next_svc - Return each successive configured PRT
Service
Name: prt_api_next_svc
Description:
The first time this routine is called, the svc_rec should be the address of a NULL
pointer. The schema record associated with the first configured PRT service will be
returned in the svc_rec and the service id copied into the prt_svc_id string. Each
subsequent call will use the svc_rec pointer to get the next service (by search order, as
configured in the PRT_SERVICE file) and return a pointer to this record in svc_rec (as
well as copying the prt_svc_id).
Syntax:
int prt_api_next_svc ( svc_rec, prt_svc_id )
struct prt_service **svc_rec;
char
prt_svc_id[SERVICE_ID_LEN + 1];
Data Structures:
See Static Information Requirements
Input Arguments:
svc_rec
Pointer to a pointer to a PRT_SERVICE record
(record in the PRT_API internal schema which
contains information on configured PRT services.
Output Arguments:
svc_rec
Pointer to a pointer to a PRT_SERVICE record
(record in the PRT_API internal schema which
contains information on configured PRT services.
Each successive call returns a pointer to a new
PRT_SERVICE record.
prt_svc_id
PRT Service identifier
Return Value:
Either COR_SUCCESS or COR_WARNING.
COR_SUCCESS is returned as long as the next service has been found. When there are
no more services to be returned (the entire schema has been run through),
COR_WARNING is returned.
GFK-1216F
Production Tracking Application Interface
5-81