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

See Also

INtimeDotNet system calls, Mailbox system calls