Método ITMedia::p ut_MediaTitle

[ Los controles e interfaces de conferencia de telefonía IP de encuentro no están disponibles para su uso en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La API de cliente RTC proporciona una funcionalidad similar.]

El método put_MediaTitle establece un título textual para el medio que la aplicación puede usar con fines informativos o de presentación. Debe ser una cadena convertible ASCII si el juego de caracteres es ASCII. De lo contrario, puede ser cualquier cadena BSTR .

Sintaxis

HRESULT put_MediaTitle(
  [in] BSTR pMediaTitle
);

Parámetros

pMediaTitle [in]

Puntero a un BSTR que contiene el título del medio.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro pMediaTitle no es un puntero válido.
E_INVALIDARG	El parámetro pMediaTitle no es válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_FAIL	Error no especificado.
E_NOTIMPL	Este método aún no se ha implementado.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pMediaTitle y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

Esta función puede enviar datos a través de la conexión en forma sin cifrar; por lo tanto, es posible que alguien intercepte en la red pueda leer los datos. El riesgo de seguridad de enviar los datos en texto no cifrado debe tenerse en cuenta antes de usar este método.

Requisitos

Requisito	Value
Versión de TAPI	Requiere TAPI 3.0 o posterior
Encabezado	Sdpblb.h
Biblioteca	Uuid.lib
Archivo DLL	Sdpblb.dll

Consulte también

ITMedia

ITMedia::get_MediaTitle