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 .