Share via

INmConference::Host

  • Article

The Host method activates a conference and makes the local user a member of the conference, creating a self-hosted, one-member conference. Use this method to make the local user the top provider (the member in charge of the conference). Calling this method has the same effect as choosing the Host Meeting menu item in NetMeeting 3.

HRESULT Host(void);

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 conference object is now the host.
  • E_FAIL
    The conference object is not idle.
  • NM_E_NO_T120_CONFERENCE
    The conference object does not have data capabilities.

Remarks

The conference must be in the idle state to be set as a host (state must be NM_CONFERENCE_IDLE). When a client hosts a conference, all the channels specified in the CreateConference uchCaps parameter are added to the conference except the file transfer channel. This channel is added only when there is more than one member in a conference.

The conference must have data capabilities to be a host (must have NMCH_DATA set). For more information, see INmManager::CreateConference.

A hosted conference does not end when the last remote participant leaves the conference.

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.