IEnumCallHub::Next-Methode (tapi3if.h)

  • Artikel

Die Next-Methode ruft die nächste angegebene Anzahl von Elementen in der Enumerationssequenz ab. Diese Methode ist für Visual Basic- und Skriptsprachen ausgeblendet.

Syntax

HRESULT Next(
  [in]  ULONG     celt,
  [out] ITCallHub **ppElements,
  [out] ULONG     *pceltFetched
);

Parameter

[in] celt

Anzahl der angeforderten Elemente.

[out] ppElements

Zeiger auf die ITCallHub-Liste der zurückgegebenen Zeiger.

[out] pceltFetched

Zeiger auf die Anzahl der tatsächlich bereitgestellten Elemente. Kann NULL sein, wenn celt eins ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode hat die Anzahl der Elemente zurückgegeben.
S_FALSE
 Die Anzahl der verbleibenden Elemente war kleiner als celt.
E_POINTER
 Der ppElements-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY
 Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.

Hinweise

TAPI ruft die AddRef-Methode auf der von IEnumCallHub::Next zurückgegebenenITCallHub-Schnittstelle auf. Die Anwendung muss Release auf der ITCallHub-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (einschließlich Tapi3.h)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

CallHub-Objekt