Returns a transaction structure to the pool. In normal circumstances the transaction is returned when it is delivered to a port, or canceled, but certain error-handling conditions might make explicit cleaning up necessary.

BOOLEAN ReleaseTransaction(
   RTHANDLE hPort,
    LPTRANSACTION lpTransaction
);

Parameters

hPort

A handle for the port where the transaction was previously allocated.

lpTransaction

A pointer to the TRANSACTION structure to be released.

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 hPort parameter is not a valid handle.

E_TYPE 0x8002

The hPort parameter is not a handle for a port.

E_NUC_BAD_BUF 0x80E2

The lpTransaction parameter is not a valid pointer.

Requirements

See Also

RT Service system calls, TRANSACTION