ITMedia::p ut_MediaName-Methode
[ Steuerelemente und Schnittstellen für Rendezvous-IP-Telefonkonferenzen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]
Die put_MediaName-Methode legt den Mediennamen fest. Definierte Medien sind Audio, Video, Whiteboard, Text und Daten.
Syntax
HRESULT put_MediaName(
[in] BSTR pMediaName
);
Parameter
-
pMediaName [in]
-
Zeiger auf einen BSTR , der den festzulegenden Mediennamen enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der pMediaName-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. |
|
Unbekannter Fehler. |
|
Diese Methode ist noch nicht implementiert. |
Bemerkungen
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pMediaName-Parameter zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.
Diese Funktion kann Daten unverschlüsselt über das Kabel senden; Daher kann jemand, der im Netzwerk lauscht, die Daten lesen. Das Sicherheitsrisiko beim Senden der Daten im Klartext sollte vor der Verwendung dieser Methode berücksichtigt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 3.0 oder höher. |
| Header |
|
| Bibliothek |
|
| DLL |
|