PTMAP_add_setpoint_chgapproval | CIMPLICITY 11 Documentation

This subroutine adds a setpoint request to a shopping list, including the change approval information. 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_chgapproval  ( sl_adr,
                                      point_adr,
                                      point_value,
                                      req_adr,
                                      changeapproval_obj,
                                      retstat )
PTMAP_ADDR         *sl_adr;
PTMAP_ADDR         *point_adr;
PTM_DATA           *point_value;
PTMAP_ADDR         *req_adr;
ChangeapprovalInfo *changeapproval_obj;
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.
`changeapproval_obj`	A pointer to the change approval information for the setpoint operation. If there is no change approval data, this should be NULL.

Output Arguments


`req_adr`	Identifier used to reference this request.
`Retstat`	Pointer to status structure. The following warnings may be returned. PTMAP_ADDR_PTR_NULL PTM_BAD_PERFORMUSRID_PASSWORD PTM_BAD_VERIFYUSRID_PASSWORD PTMAP_CHANGEAPPROVAL_SAME_USERID
	PTMAP_DATA_ELEM_MISMATCH PTMAP_DATA_LEN_MISMATCH
	PTMAP_DATA_NULLPTR
	PTMAP_DATA_TYPE_MISMATCH PTMAP_SEQ_NUM_MISMATCH PTMAP_SL_ADDR_NOTF
	PTMAP_SL_ADR_NULL
	PTM_INVAL_CHANGEAPPROVAL_LEVEL PTM_INVAL_CHANGEAPPROVAL_RESOURCESETPOINT PTM_INVAL_PERFORMUSERID PTM_INVAL_VERIFYUSERID
	PTM_NO_PERFORMUSERID PTM_NO_PERFORM_PRIV PTM_NO_VERIFYUSERID PTM_NO_VERIFY_PRIV PTM_PERFORMER_PASSWORD_EXPIRED PTM_POINT_HASCHANGEAPPROVAL PTM_VERIFIER_PASSWORD_EXPIRED

Return Value

The contents of retstat.status .