IEnumParticipant::Next-Methode

[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 vor Visual Basic und Skriptsprachen verborgen.

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 die von Celt.
E _ POINTER
Der ppElements-Parameter ist kein gültiger Zeiger.
E _ OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher zum Ausführen des Vorgangs vorhanden.

Hinweise

TAPI ruft die AddRef-Methode für die ITAgentHandler-Schnittstelle auf, die von IEnumParticipant::Next zurückgegeben wird. 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