INmConference::CreateDataChannel
The CreateDataChannel method provides a pointer to an INmChannelData interface on a new Channel object. This data channel, identified by your application's globally unique identifier (GUID), can be used to transmit information between instances of your application running on each conference participant's computer.
HRESULT CreateDataChannel(
INmChannelData **ppChannel,REFGUID rguid);
Parameters
- ppChannel
[out] Pointer to a pointer to the INmChannelData interface on the new Data Channel object. - rguid
[in] GUID of the data channel.
Return Values
NetMeeting client applications can use the SUCCEEDED and FAILED macros in winerror.h to check return values.
Return values can include RPC layer errors or any of the following values.
- S_OK
The data channel was created successfully. - E_INVALIDARG
The rguid parameter contains an invalid value. - E_FAIL
The channel cannot be created, or internal resources are not available. - E_OUTOFMEMORY
Memory could not be allocated to service the request.
Remarks
Typically, an application has only one data channel and uses its own application GUID to identify the channel. However, an application can create multiple data channels and identify each one with a different GUID.
NetMeeting SDK client applications should use INmMember::GetNmchCaps to monitor a member's channel capabilities for NMCH_DATA before calling methods that depend on a data channel being active.
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.
** Header:** Imsconf2.idl.