PTMAP_get_point
This subroutine gets the response to a request for a specific point. If more than a single request is outstanding for a point, this function should be called once for each request. If no response is available for the specified request, this function returns COR_WARNING.
Syntax
int PTMAP_get_point (point_adr, sl_adr, req_adr,
??????????????????????????????????????????rsp_type, rsp_stat, rsp_ptr,
??????????????????????????????????????????retstat)
PTMAP_ADDR????*point_adr;
PTMAP_ADDR????*sl_adr;
PTMAP_ADDR????*req_adr;
int??????????????????*rsp_type;
COR_STATUS????*rsp_stat;
PTM_RSP??????????**rsp_ptr;
COR_STATUS????*retstat;
Input Arguments
point_adr | Pointer to the point. |
Output Arguments
sl_adr | Pointer to the Shopping List associated with this request. |
req_adr | Pointer to the request for which the response was generated.. |
rsp_type | Request type (such as, PTM_ONCHANGE or PTM_SNAPSHOT). |
rsp_stat | Status of the response: COR_SUCCESS, COR_WARNING, or COR_FAILURE. |
rsp_ptr | Pointer to a response structure. |
Retstat | Pointer to status structure. The following errors may be returned (see Appendix A for an explanation of this code): |
PTMAP_ADR_PTR_NULL | |
PTMAP_PT_ADR_NULL | |
PTMAP_PT_ADR_NOTF | |
PTMAP_SEQ_NUM_MISMATCH | |
The following warnings may be returned: | |
PTMAP_NO_RSP_RCV | |
PTMAP_RCV_QUE_ERR |
Return Value
The contents of retstat.status.