Returns a TRANSACTION buffer from the service transaction pool. The following fields are initialized:

• wTransID set to transaction ID.
• hPort set to port handle.
• wFlags, hTask, lpMsg and wSendStatus set to 0 (zero).

LPTRANSACTION RequestTransaction(
    RTHANDLE hPort,
    LPWORD lpwTransID
);

Parameters

hPort

A handle for the port where the transaction is to be allocated.

lpwTransID

A pointer to a WORD variable where the allocated transaction id is returned.

Return Values

A pointer to a TRANSACTION structure, initialized as described above.

Success.

NULL

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 lpwTransID parameter is not a valid pointer.

E_TRANS_LIMIT 0x00EA

The port transaction table is full, or there are no transaction buffers available.

Requirements

See Also

RT Service system calls, TRANSACTION