Sends an object handle to an object mailbox.

NTXSTATUS ntxSendRtHandle(
    NTXHANDLE hMailbox,
    NTXHANDLE hObject,
    NTXHANDLE hResponse
);

Parameters

hMailbox

RT object mailbox to send the handle to.

hObject

Handle to send.

hResponse

Handle for an RT mailbox or RT semaphore to be passed to the receiver of hObject. This may be NULL. Specific usage of this object is up to the application.

Return Values

E_OK

Success

The status code

Failure

Status

E_OK 0x0000

No exceptional conditions occurred.

E_MEM 0x0002

The high performance queue is full and the calling thread's process does not contain sufficient memory to complete the call.

E_EXIST 0x0006

One or more parameters is not a handle for an existing object.

E_TYPE 0x8002

At least one of these is true:

• hMailbox is not an object mailbox.
• hResponse is a handle for an object that is neither a mailbox nor a semaphore.

E_NTX_INTERNAL_ERROR 0x001

The DLL could not contact the RT kernel to complete the request.

Requirements

See Also

Mailbox system calls