INtime SDK Help
ntxSendRtHandle
INtime SDK v7.1 > About INtime > INtime Kernel > Mailboxes > ntxSendRtHandle

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

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (for 64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib

See Also

Mailbox system calls