IEnumPhone::Next-Methode (tapi3if.h)

Artikel
03/02/2024

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

Syntax

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

Parameter

[in] celt

Anzahl der angeforderten Elemente.

[out] ppElements

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

[in, 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_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
E_POINTER	Der ppElements-Parameter ist kein gültiger Zeiger.

Hinweise

TAPI ruft die AddRef-Methode auf der ITPhone-Schnittstelle auf, die von IEnumPhone::Next zurückgegeben wird. Die Anwendung muss Release auf der ITPhone-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Anforderungen

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

Weitere Informationen

IEnumPhone

ITPhone

Freigeben über