Sends a response message to an earlier received SendRtMessageRSVP message.

BOOLEAN SendRtReply(
    RTHANDLE hPort,            // port handle
    LPGENADDR lpAddress,       // pointer to destination address
    WORD wTransID,             // transaction ID for this request/response transaction
    LPBYTE lpControl,          // pointer to control message
    WORD wControlLength,       // length of control message
    LPVOID lpData,             // pointer to data message
    DWORD dwDataSize,          // length of data message
    WORD wTransmissionFlags    // transmission flags
);

Parameters

hPort

A handle for the port to where the message is to be sent.

lpAddress

A pointer to an address structure indicating the remote port to where the message is to be sent.

wTransID

The transaction number of the message.

lpControl

A pointer to the message to be sent.

wControlLength

The number of bytes in the message to be sent.

lpData

A pointer to a buffer or data chain containing the data part (if any) of the message to be sent.

dwDataSize

The number of bytes in the data part of the message to be sent.

wTransmissionFlags

The parameter default is a contiguous buffer, synchronous transmission and EOT. Some of the following values may be combined to form the flags parameter: Some of the following values may be combined to form the flags parameter:

Choose one of these to select the data type:

CONTIGUOUS_BUFFER	Specifies that lpData reference a contiguous buffer.
DATA_CHAIN_BUFFER	Specifies that lpData reference a data chain block.
DATA_LIST_BUFFER	Specifies that lpData reference the first element in a data list.

Choose one of these values to select the transmission mode:

SYNC_MODE	Specifies that the message should be transmitted synchronously.
ASYNC_MODE	Specifies that the message should be transmitted asynchronously.

Specify this value to indicate that this message is not the last part of a transmission:

NOT_EOT

Specifies that this is not yet the last transmission for this response message and there are more transmissions to follow.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_CONTEXT 0x0005

One of these conditions exist:

• The port is an anonymous sink port.
• The service does not support RSVP transactions.

E_EXIST 0x0006

The port is already being deleted.

E_NOT_CONFIGURED 0x0008

The service does not have a SendMessage handler.

E_TRANSMISSION 0x000B

One of these conditions exist:

• The destination port does not exist or is invalid (short circuit).
• A hardware error occurred during transmission.

E_INVALID_ADDR 0x00E2

The address parameter is not valid.

E_RESOURCE_LIMIT 0x00E6

Insufficient control buffers are available.

E_TRANS_ID 0x00E8

The wTransId parameter is not valid.

E_DISCONNECTED 0x00E9

The destination port is connected to another port.

E_TRANS_LIMIT 0x00EA

The transaction limit for either the port or the service has been exceeded.

E_UNBOUND 0x00EB

The port has not been bound.

E_TYPE 0x8002

The handle supplied is not for a port object.

E_PARAM 0x8004

One of these conditions exist:

• An address parameter was supplied for a non-addressed service.
• The control message length supplied is too great.

E_NUC_BAD_BUF 0x80E2

One of these conditions exist:

• The control message pointer was invalid.
• The data pointer was invalid.

Note:   Other status values may be generated by the service-specific SendMessage handler.

Requirements

See Also

Port system calls, SendRtMessageRSVP, SendRtMessage, SendMessage