IAppletSession::SendData

Use the SendData method to distribute data to other conference participants. SendData handles both uniform and nonuniform send operations. IAppletSessionNotify::SendDataIndication is the event sink for this method.

HRESULT SendData(
  BOOL fUniformSend,
  AppletChannelID nChannelID,
  AppletPriority ePriority,
  ULONG cbBufSize,
  BYTE *pBuffer
);

Parameters

fUniformSend
[in] Determines whether to use the uniform-send mechanism to distribute this data. If TRUE, use a uniform-send operation. Using a uniform-send operation ensures that each applet receives data in the same order every time data is sent. Normal-send data operations provide data delivery through the shortest route, thus minimizing network traffic and latency. As a result, applets may receive data in different orders each time data is sent. The applet that sends data does not receive a copy of the data when using the normal-send operation.
nChannelID
[in] A value of type AppletChannelID identifying the data channel.
ePriority
[in] A value from the AppletPriority enumeration that indicates the priority for the data transmission.
cbBufSize
[in] The number of characters in the buffer pointed to by pBuffer.
pBuffer
[in,size_is(cbBufSize)] Pointer to the buffer.

Return Values

S_OK
This data has been sent successfully.
E_INVALIDARG
The parameter cbBufsize is 0 or pBuffer is NULL or both.
APPLET_E_NO_SERVICE
The T.120 services cannot be started or are not available.
APPLET_E_SERVICE_FAIL
There has been a failure in the T.120 services.

Remarks

An applet must join a channel (through IAppletSession::ChannelRequest ) to receive the data sent to this channel. The sender is not required to join the channel. There is no notification when the data is actually sent to the wire. The SendDataIndication notification occurs when new data arrives and is available.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires NetMeeting 3.0 or later.
  Header: Iapplet.idl.

 

Show: