This call is used to terminate a transmit operation, usually from the service thread. It should be used where a SendMessage handler returned with the status set to E_TRANSMIT_NOT_COMPLETE. If the user has called a Send function with the ASYNC flag set, the calling thread is woken up and the return status set to the value given in this call. If an asynchronous transmission was started and either the transmission failed or the NOTIFY_ALWAYS transmission flag was specified in the original call, this call queues a status message on the originating port.

In either case, the transaction is terminated and the transaction and control buffers released to their respective pools by this call.

BOOLEAN DeliverStatus(
    LPTRANSACTION lpTransaction, 
    WORD wStatusCode
);

Parameters

lpTransaction

A pointer to the transaction to be terminated.

wStatusCode

The status to be returned to the caller, or in the status message.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_CONTEXT 0x0005

The port is being deleted.

E_EXIST 0x0006

The port does not exist.

E_TYPE 0x8002

The hPort field in the control buffer does not contain a handle for a port.

E_NUC_BAD_BUF 0x80E2

The lpTransaction parameter contains an invalid pointer.

Requirements

See Also

RT Service system calls, SendMessage