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
S_OK	Methode war erfolgreich.
E_POINTER	Der ppMedia-Parameter ist kein gültiger Zeiger.
E_INVALIDARG	Der Index-Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
E_FAIL	Unbekannter Fehler.
E_NOTIMPL	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	Sdpblb.h
Bibliothek	Uuid.lib
DLL	Sdpblb.dll

Siehe auch

ITMedia

ITMediaCollection