Returns memory to the system. When the message received by ntxReceive is not a response to a previous request, the system allocates memory for the Windows application. By using this call, the memory is returned to the system for later use.

Returns a previously-allocated buffer to its heap. The buffer must have been allocated from the heap to which it is being returned. It does not have to be returned by the same process that allocated it.

NTXSTATUS ntxReleaseRtBuffer(
    NTXHANDLE hPort, 
    LPVOID lpReceiveBuffer
);

Parameters

hPort

Specifies the port and heap to which to release the buffer.

lpReceiveBuffer

Specifies a pointer returned from a call to ntxReceiveRtMessage.

Return Values

E_OK

Success.

The appropriate status code.

Failure. To determine the status, call ntxGetLastRtError.

Status

E_LOCATION

The RT client on which the port was created is now invalid.

E_NTX_INTERNAL_ERROR

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

Requirements

See Also

Port system calls, ntxReceiveRtMessage