Receives a reply message to an earlier RSVP transmission. The port cannot be a sink port.
LPVOID ntxReceiveRtReply(
NTXHANDLE hPort,
NTXXID TransId,
DWORD dwMilliseconds,
RECEIVEINFO pReceiveInfo
);
Parameters
hPort
- The port that will receive the message.
TransId
- The transaction ID returned to the caller during the send phase of the transaction.
dwMilliseconds
- The time limit, in milliseconds, which the call will wait for a message to arrive, or INFINITE to wait forever.
pReceiveInfo
- A RECEIVEINFO structure, initially passed in with the length field set, which will be filled in when the message arrives.
Return Values
- A pointer to a buffer containing the data part of the message or
NULL
.
- Success.
- A BAD_POINTER value.
- Failure. To determine the status, call ntxGetLastRtError.
Status
E_OK 0x0000
- No exceptional conditions occurred.
E_TIME
- The number of milliseconds defined in
dwMilliseconds
elapsed before a message was received.
E_EXIST 0x0006
- The port is already being deleted.
E_STATE 0x0008
- The port is a sink port with no ports forwarded to it.
E_TRANS_ID 0x00E8
- The
wTransId
parameter is not valid.
E_TYPE 0x8002
- The handle supplied is not for a port object.
E_NUC_BAD_BUF 0x80E2
- The receive info pointer was invalid.
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
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
Port system calls, RECEIVEINFO