PTMAP_modifysetpoint_chgapproval

This subroutine modifies an existing setpoint request requiring change approval. The application must specify the request and the new point value. Following a call to this function, the application must call a PTMAP_send function to initiate the download to the device.

Syntax

int PTMAP_modify_setpoint_chgapproval  ( point_adr,
                                         point_value,
                                         req_adr,
                                         changeapproval_obj,
                                         retstat )
PTMAP_ADDR         *point_adr;
PTM_DATA           *point_value;
PTMAP_ADDR         *req_adr;
ChangeapprovalInfo *changeapproval_obj;
COR_STATUS  *retstat;

Input Arguments

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_REQ_NOT_ENBL PTMAP_REQ_CUR_OUT PTMAP_REQ_NOT_FOUND
The following errors may also be returned: PTMAP_CHANGEAPPROVAL_SAME_USERID PTM_BAD_PERFORMUSRID_PASSWORD PTM_BAD_VERIFYUSRID_PASSWORD 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 .