ITMediaCollection::Create-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 Create-Methode erstellt ein neues Medium mit Standardeigenschaften, fügt es der Auflistung am angegebenen Index hinzu und gibt einen Zeiger auf die ITMedia-Schnittstelle zurück.
Syntax
HRESULT Create(
[in] LONG Index,
[out] ITMedia **ppMedia
);
Parameter
-
Index [in]
-
Index für das neue Element. Der Mindestwert für den Index ist 1, und der Höchstwert für den Index ist die aktuelle Anzahl von Elementen + 1.
-
ppMedia [out]
-
Zeiger auf die erstellte ITMedia-Schnittstelle .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der ppMedia-Parameter ist kein gültiger Zeiger. |
|
Der Index-Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. |
|
Unbekannter Fehler. |
|
Diese Methode ist noch nicht implementiert. |
Bemerkungen
Die meisten C- und C++-Listen sind 0-basiert, aber dieser Index ist für die Visual Basic-Kompatibilität 1-basiert, was bedeutet, dass das erste Element die Indexnummer 1 aufweist.
TAPI ruft die AddRef-Methode auf der ITMedia-Schnittstelle auf, die von ITMediaCollection::Create zurückgegeben wird. Die Anwendung muss Release auf der ITMedia-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 3.0 oder höher. |
| Header |
|
| Bibliothek |
|
| DLL |
|