PTMAP_cancel_req

This subroutine cancels a request that has been sent to Point Management. For example, if an "On-Change" request has been sent to Point Management, this function can be used to cancel that request. When this request is made, a message is sent to Point Management, and the application waits until a response is received from Point Management. The request is still part of the Shopping List, but it is no longer active. The request can be made active by sending the Shopping List a second time.

An error is returned if no outstanding response exists for the specified request.

Syntax

int PTMAP_cancel_req (can_req_adr, retstat)

PTMAP_ADDR  *can_req_adr;

COR_STATUS  *retstat;

Input Arguments

can_req_adr

The identifier that was returned when the request was made.

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_REQ_ADR_NULL

 

PTMAP_REQ_ADDR_NOTF

 

PTMAP_SEQ_NUM_MISMATCH

 

PTMAP_REQ_NOT_OUT

Return Value

The contents of retstat.status.

More information

Point Management API subroutines.