Metodo ITMedia::p ut_MediaTitle

[ I controlli e le interfacce di telefonia IP rendezvous IP non sono disponibili per l'uso in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'API client RTC offre funzionalità simili.

Il metodo put_MediaTitle imposta un titolo testuale per il supporto che l'applicazione può usare per scopi informativi o di visualizzazione. Deve trattarsi di una stringa convertibile ASCII se il set di caratteri è ASCII. In caso contrario, può essere qualsiasi stringa BSTR .

Sintassi

HRESULT put_MediaTitle(
  [in] BSTR pMediaTitle
);

Parametri

pMediaTitle [in]

Puntatore a una stringa BSTR contenente il titolo del supporto.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_POINTER
Il parametro pMediaTitle non è un puntatore valido.
E_INVALIDARG
Il parametro pMediaTitle non è valido.
E_OUTOFMEMORY
Memoria insufficiente per eseguire l'operazione.
E_FAIL
Errore non specificato.
E_NOTIMPL
Questo metodo non è ancora implementato.

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per il parametro pMediaTitle e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

Questa funzione può inviare dati in transito in formato non crittografato; pertanto, un utente che esegue l'intercettazione sulla rete potrebbe essere in grado di leggere i dati. Il rischio di sicurezza di inviare i dati in testo non crittografato deve essere considerato prima di usare questo metodo.

Requisiti

Requisito Valore
Versione TAPI
Richiede TAPI 3.0 o versione successiva
Intestazione
Sdpblb.h
Libreria
Uuid.lib
DLL
Sdpblb.dll

Vedi anche

ITMedia

ITMedia::get_MediaTitle