This subroutine adds a request for a "Snapshot" of a point to a Shopping List. The current point value is returned by Point Management after the Shopping List has been sent.
Syntax
PTMAP_add_snapshot ( sl_adr, point_adr, req_adr,
retstat )
PTMAP_ADDR *sl_adr;
PTMAP_ADDR *point_adr;
PTMAP_ADDR *req_adr;
COR_STATUS *retstat;
Input Arguments
sl_adr |
A Shopping List ID created by a call to PTMAP_add_sl. |
point_adr |
A Point ID created by a call to PTMAP_add_point. |
Output Arguments
req_adr |
Identifier used to reference this request. |
Retstat |
Pointer to status structure. The following errors may be returned (see Appendix A for an explanation of this code): |
|
PTMAP_ADDR_PTR_NULL |
|
PTMAP_SL_ADR_NULL |
|
PTMAP_SL_ADDR_NOTF |
|
PTMAP_SEQ_NUM_MISMATCH |
Return Value
The contents of retstat.status.
Point Management API subroutines. |