This subroutine disables or enables all requests in a Shopping List. This function is useful when an application needs to disable all but a few points. All points can be disabled and then a few points can be selectively enabled using PTMAP_set_req.
Syntax
int PTMAP_set_sl (sl_adr, enabled_state, retstat)
PTMAP_ADDR *sl_adr;
COR_BOOLEAN enabled_state;
COR_STATUS *retstat;
Input Arguments
sl_adr |
Pointer to the Shopping List. |
enabled_state |
New state for the request. |
|
Either TRUE (enabled) or FALSE (DISABLED). |
Output Arguments
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 |
Return Value
The contents of retstat.status.
Point Management API subroutines. |