Partager via


ITMedia::p ut_MediaTitle, méthode

[ Les contrôles et interfaces de conférence de téléphonie IP rendez-vous ne sont pas disponibles pour une utilisation dans Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’API cliente RTC fournit des fonctionnalités similaires.]

La méthode put_MediaTitle définit un titre textuel pour le média que l’application peut utiliser à des fins d’information ou d’affichage. Il doit s’agir d’une chaîne convertible ASCII si le jeu de caractères est ASCII. Sinon, il peut s’agir de n’importe quelle chaîne BSTR .

Syntaxe

HRESULT put_MediaTitle(
  [in] BSTR pMediaTitle
);

Paramètres

pMediaTitle [in]

Pointeur vers un BSTR contenant le titre du média.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
La méthode a réussi.
E_POINTER
Le paramètre pMediaTitle n’est pas un pointeur valide.
E_INVALIDARG
Le paramètre pMediaTitle n’est pas valide.
E_OUTOFMEMORY
La mémoire est insuffisante pour effectuer l’opération.
E_FAIL
Erreur non spécifiée.
E_NOTIMPL
Cette méthode n'est pas encore implémentée.

Notes

L’application doit utiliser SysAllocString pour allouer de la mémoire pour le paramètre pMediaTitle et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

Cette fonction peut envoyer des données sur le câble sous forme non chiffrée ; par conséquent, une personne qui écoute le réseau peut être en mesure de lire les données. Le risque de sécurité lié à l’envoi des données en texte clair doit être pris en compte avant d’utiliser cette méthode.

Spécifications

Condition requise Valeur
Version TAPI
Nécessite TAPI 3.0 ou version ultérieure
En-tête
Sdpblb.h
Bibliothèque
Uuid.lib
DLL
Sdpblb.dll

Voir aussi

ITMedia

ITMedia::get_MediaTitle