IEnumParticipant::Next-Methode

Artikel
06/13/2023

[Next ist nicht für die Verwendung in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]

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] ITParticipant **ppElements,
  [out] ULONG         *pceltFetched
);

Parameter

celt [in]: Anzahl der angeforderten Elemente.
ppElements [out]: Zeiger auf ITAgentHandler-Schnittstellen .
pceltFetched [out]: 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.

Bemerkungen

TAPI ruft die AddRef-Methode für die von IEnumParticipant::Next zurückgegebeneITAgentHandler-Schnittstelle auf. Die Anwendung muss Release auf der ITAgentHandler-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Anforderungen

Anforderung	Wert
TAPI-Version	Erfordert TAPI 3.0 oder höher
Header	Confpriv.h
Bibliothek	Uuid.lib
DLL	Tapi3.dll

Weitere Informationen

IEnumParticipant
ITParticipant

Freigeben über