PTMAP_get_point_ChangeApprovalinfo
This subroutine sends a request to Point Management for information about the point data type including change approval information.
Syntax
iint PTMAP_get_point_info_ChangeApprovalinfo (point_adr,
??????????????????????????????????????????????????????????????????????????????????????????data_type,
??????????????????????????????????????????????????????????????????????????????????????????data_length,
??????????????????????????????????????????????????????????????????????????????????????????elements,
??????????????????????????????????????????????????????????????????????????????????????????data_size,
??????????????????????????????????????????????????????????????????????????????????????????display_format,
??????????????????????????????????????????????????????????????????????????????????????????change_approval_mask,
??????????????????????????????????????????????????????????????????????????????????????????retstat)
PTMAP_ADDR ??????????*point_adr;
PTM_DATA_TYPE ????*data_type;
PTM_DATA_LENGTH *data_length;
PTM_ELEMENTS ??????*elements;
COR_I4 ??????????????????*data_size;
CHAR ??????????????????????*display_format;
int ????????????????????????*change_approval_mask;
COR_STATUS ??????????*retstat;
Input Arguments
point_adr
|
Pointer to the point. |
Output Arguments
data_type
|
Point data type. |
data_length
|
The length of the data type. |
Elements
|
Number of elements in point. |
data_size
|
Total data size. |
display_format
|
The configured display format from POINT.DAT. |
change_approval_mask
|
Flag indicating what type of change approval is required for the point
|
Retstat
|
Pointer to status structure. The following errors may be returned. PTMAP_ADR_PTR_NULL PTMAP_PT_ADR_NULL PTMAP_PT_ADR_NOTF PTMAP_SEQ_NUM_MISMATCH PTM_POINT_HASCHANGEAPPROVAL: PTM_NO_PERFORMUSERID: PTM_NO_VERIFYUSERID: PTM_BAD_PERFORMUSRID_PASSWORD: PTM_BAD_VERIFYUSRID_PASSWORD: PTM_NO_PERFORM_PRIV: PTM_NO_VERIFY_PRIV: PTM_INVAL_CHANGEAPPROVAL_LEVEL: PTM_INVAL_CHANGEAPPROVAL_RESOURCESETPOINT: PTM_INVAL_PERFORMUSERID: PTM_INVAL_VERIFYUSERID: PTMAP_CHANGEAPPROVAL_SAME_USERID: PTM_VERIFIER_PASSWORD_EXPIRED: PTM_PERFORMER_PASSWORD_EXPIRED: |
Return Value
The contents of retstat.status.