This call is typically made from the service thread, when it has been determined a complete transactionless message is ready to deliver to a port. If the message is the response part of a transaction, use DeliverTransaction instead.

BOOLEAN DeliverMessage(
    RTHANDLE hPort, 
    LPCONTROLBUFFER lpControlBuffer
);

Parameters

hPort

The handle of the port where the message is to be delivered.

lpControlBuffer

A pointer to the control buffer which is to be delivered.

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_NO_LOCAL_BUFFER 0x00E3

The data part of the message did not originate from the heap attached to the port.

E_TYPE 0x8002

The hPort parameter is not a handle for a port.

E_NUC_BAD_BUF 0x80E2

The lpControlBuffer parameter contains an invalid address.

Requirements

See Also

RT Service system calls, DeliverTransaction