INmChannelData
Use the INmChannelData interface to manage the exchange of data between specific members of a conference.
When to Implement
You do not need to implement this interface because the NetMeeting 3 run time provides the INmChannelData implementation on the Data Channel object. However, you need to implement the corresponding event handler methods for INmChannelDataNotify.
When to Use
Call the INmChannelData methods from your NetMeeting client application to check the state of an audio channel or to set and retrieve the channel's properties. Before calling any of the INmChannelData methods listed below, users should confirm that the NMCH_DATA bit is set for this channel by using INmSysInfo::GetNmchCaps to retrieve the local system channel capabilities.
Methods in Vtable Order
| IUnknown methods | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments reference count. |
| Release | Decrements reference count. |
| INmChannel methods | Description |
|---|---|
| IsSameAs | Checks whether this Channel object and one other Channel object represent the same channel. |
| IsActive | Checks whether this channel is currently engaged in some activity. |
| SetActive | Activates a channel. |
| GetConference | Finds the conference using this channel. |
| GetInterface | Retrieves the interface identifier (IID) that identifies this channel. |
| GetNmch | Retrieves the NMCH type for this channel. |
| EnumMember | Retrieves an enumerator to list all the members using this channel. |
| GetMemberCount | Retrieves the number of members using this channel. |
| INmChannelData methods | Description |
|---|---|
| GetGuid | Retrieves the globally unique identifier (GUID) that identifies a specific data channel. |
| SendData | Sends a block of data through a channel to another conference member. |
Remarks
Use INmConference::CreateDataChannel to create Data Channel objects.
Typically, an application has only one data channel and uses its own GUID to identify the channel. However, an application can create multiple data channels and identify each one by a different GUID.
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.
See Also
INmChannelDataNotify, Using the NetMeeting Data Channel, Further Reading