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 |
|---|---|
|
Die Methode hat die anzahl der Elemente zurückgegeben. |
|
Die Anzahl der verbleibenden Elemente war kleiner als die von Celt. |
|
Der ppElements-Parameter ist kein gültiger Zeiger. |
|
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 |
|
| Bibliothek |
|
| DLL |
|