Edit

Share via

ITSdp::get_MediaCollection method

  • Article

[ Rendezvous IP Telephony Conferencing controls and interfaces are not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The RTC Client API provides similar functionality.]

The get_MediaCollection method gets a pointer to the ITMediaCollection interface for the conference.

Syntax

HRESULT get_MediaCollection(
  [out] ITMediaCollection **ppMediaCollection
);

Parameters

ppMediaCollection [out]

Pointer to ITMediaCollection.

Return value

This method can return one of these values.

Value Meaning
S_OK
 Method succeeded.
E_INVALIDARG
 The ppMediaCollection parameter is not a valid pointer.
E_OUTOFMEMORY
 Insufficient memory exists to perform the operation.
E_FAIL
 Unspecified error.
HRESULT_FROM_ERROR_CODE(ERROR_INVALID_DATA)
 An internal error has occurred, usually due to the failure of a previous method.
E_NOTIMPL
 This method is not yet implemented.

Remarks

An ITMediaCollection pointer could also be obtained using QueryInterface.

TAPI calls the AddRef method on the ITMediaCollection interface returned by ITSdp::get_MediaCollection. The application must call Release on the ITMediaCollection interface to free resources associated with it.

Requirements

Requirement Value
TAPI version
 Requires TAPI 3.0 or later
Header
Sdpblb.h
Library
Uuid.lib
DLL
Sdpblb.dll

See also

ITSdp

ITMediaCollection