Cancels an RSVP message transmission in progress, or the status reporting phase of an asynchronous send operation.

Performs synchronous cancellation of RSVP message transmission.

If an ntxSendRtMessage operation is cancelled, then it must have returned a valid transaction ID, supplied as a parameter to cancel.

If cancellation of a ntxSendRtMessageRSVP 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.

NTXSTATUS ntxCancelRtTransaction(
    NTXHANDLE hPort,
    NTXXID TransId
);

Parameters

hPort

The port on which the message was sent.

TransId

The transaction ID returned to the caller by the send operation.

Return Values

E_OK

Success.

The appropriate status code.

Failure. To determine the status, call ntxGetLastRtError.

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.

E_LOCATION

The RT client on which the port was created is now invalid.

E_NTX_INTERNAL_ERROR

The DLL could not contact the RT kernel to complete the request.

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

Requirements

See Also

Port system calls, ntxSendRtMessage, ntxSendRtMessageRSVP, SendRtMessageRSVP, CancelTransaction,