Platform SDK: TAPI

ITMedia::get_MediaTitle

Retrieves a textual title for the media that the application can use for informational or display purposes. This must be an ASCII convertible string if the character set is ASCII. Otherwise, it can be any BSTR string.

HRESULT get_MediaTitle(
  BSTR *ppMediaTitle
);

Parameters

ppMediaTitle
[out] Pointer to a BSTR containing the title of the media.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The ppMediaTitle parameter is not a valid pointer.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
E_FAIL Unspecified error.
E_NOTIMPL This method is not yet implemented.

Remarks

The application must use SysFreeString to free the memory allocated for the ppMediaTitle parameter.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Sdpblb.h.
  Library: Use Sdpblbid.lib.

See Also

ITMedia, ITMedia::Put_MediaTitle