INtime SDK Help
ntxSendRtHandle(INtimeDotNet)
INtime SDK v7 > About INtime > Alternate APIs > INtimeDotNet > ntxSendRtHandle(INtimeDotNet)

Sends an object handle to an object mailbox.

Visual Basic:

Sub ntxSendRtHandle(
  ByVal hMailbox As Integer,
  ByVal hObject As Integer,
  ByVal hResponse As Integer)

Visual C#:

void ntxSendRtHandle (
  Int32 hMailbox,
  Int32 hObject,
  Int32 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 pass to the receiver of hObject. This may be 0 Specific usage of this object is up to the application.

Status

E_MEM
The high performance queue is full and the calling thread's process does not contain sufficient memory to complete the call.
E_EXIST
One or more parameters is not a handle for an existing object.
E_TYPE
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
The DLL could not contact the RT kernel to complete the request.

Requirements

Versions Reference
INtime 3.0 INtimeDotNet

See Also

INtimeDotNet system calls, Mailbox system calls