PTMAP_add_setpoint | CIMPLICITY 11 Documentation

This subroutine adds a "Setpoint" request to a Shopping List. Point Management downloads the specified value to the device address designated by the point. The application must have a pointer to a PTM_DATA struct containing the data value. This structure must be allocated by a call to PTM_alloc_ptm_data .

Syntax:

int PTMAP_add_setpoint ( sl_adr, point_adr,
                         point_value,req_adr,
                         retstat )
PTMAP_ADDR  *sl_adr;
PTMAP_ADDR  *point_adr;
PTM_DATA    *point_value;
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 .
point_value	A pointer to a PTM_DATA structure containing the point value.

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
	PTMAP_DATA_NULLPTR
	PTMAP_DATA_TYPE_MISMATCH
	PTMAP_DATA_LEN_MISMATCH
	PTMAP_DATA_ELEM_MISMATCH

Return Value

The contents of retstat.status .