INtime SDK Help
ntxCancelRtTransaction

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

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib

See Also

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