ITConferenceDirectory::CreateConference

[This is preliminary documentation and subject to change.]

Returns a conference announcement that (including the constituent conference blob) is created with default values.

HRESULT CreateConference(
  BSTR pConferenceName,
  ITConference **ppConference
);
 

Parameters

pConferenceName

[in] Name of conference.

ppConference

[out] Pointer to ITConference interface of new conference.

Return Values

TBD

Remarks

After the conference is created by this method, its conference blob will not be written to ILS server until 1) ITConferenceBlob::CommitBlob is explicitly called, or 2) ITConference::Release is called. Without a conference blob, some operations, such as ITConferenceDirectory::GetConference will fail with error "The parameter is incorrect".

The following code fragments demonstrate the usage:

pITConfDir->CreateConference(bszConfName, &pITConf);
pITConf->Release();   // This will decrement the reference count to 0
                      // and the conference blob will be written to server.

or:

pITConfDir->CreateConference(bszConfName, &pITConf);
pITConf->QueryInterface(IID_ITConferenceBlob, &pITConfBlob);
pITConfBlob->CommitBlob();  // Conference blob will be written to server.