Performs synchronous cancellation of RSVP message transmission.

If a SendRtMessage or SendRtReply operation is canceled, then it must have returned a valid transaction ID, supplied as a parameter to cancel.

If cancellation of a SendRtMessageRSVP is successful, the reply buffer, if used, is disassociated from the port. Cancellation of a SendRtMessageRSVP operation is possible after the original request message transmission is complete and before a response message is received.

BOOLEAN CancelRtTransaction(
    RTHANDLE hPort,  
    WORD wTransID    
);

Parameters

hPort

A handle for the port.

wTransID

The transaction ID of the message to be canceled.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_EXIST 0x0006

The port is already being deleted.

E_TRANS_ID 0x00E8

The wTransId parameter is not valid.

E_TYPE 0x8002

The handle supplied is not for a port object.

Note:   Other status values may be generated by the service-specific CancelTransaction handler.

Requirements