IEnumAgent::Next-Methode (tapi3.h)

Artikel
08/26/2023

Die Next-Methode ruft die nächste angegebene Anzahl von Elementen in der Enumerationssequenz ab.

Syntax

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

Parameter

[in] celt

Anzahl der angeforderten Elemente.

[out] ppElements

Zeiger auf DEN ITAgent-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.

Wert	Bedeutung
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 für die von IEnumAgent::Next zurückgegebene ITAgent-Schnittstelle auf. Die Anwendung muss Release auf der ITAgent-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Anforderungen


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

Weitere Informationen

IEnumAgent

ITAgent

Freigeben über