When a message has been received from the interface and it is identified as a response message, the service thread must tie it up with its transaction structure. This is done by calling this interface with the transaction ID and destination (i.e., local) port handle. If the lpRemoteAddress parameter is non-null, the contents are used to validate the transaction buffer.

LPTRANSACTION GetTransaction(
    RTHANDLE hPort, 
    WORD wTransID
    LPGENADDR lpRemoteAddress
);

Parameters

hPort

A handle for a port object where the transaction was originally allocated.

wTransID

The ID of the transaction being sought.

lpRemoteAddress

A pointer to a GENADDR structure containing the address of the source of the message.

Return Values

A pointer to the transaction.

Success.

NULL if no transaction was found; BAD_POINTER if an error ocurred.

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.

Requirements

See Also

RT Service system calls, GENADDR