IEnumProgressItems::Next-Methode (imapi2fs.h)

Artikel
03/01/2024

Ruft eine angegebene Anzahl von Elementen in der Enumerationsfolge ab.

Syntax

HRESULT Next(
  [in]  ULONG         celt,
  [out] IProgressItem **rgelt,
  [out] ULONG         *pceltFetched
);

Parameter

[in] celt

Anzahl der abzurufenden Elemente.

[out] rgelt

Array von IProgressItem-Schnittstellen . Sie müssen jede Schnittstelle in rgelt freigeben, wenn Sie fertig sind.

[out] pceltFetched

Anzahl der in rgelt zurückgegebenen Elemente. Sie können pceltFetched auf NULL festlegen, wenn celt eins ist. Initialisieren Sie andernfalls den Wert von pceltFetched auf 0, bevor Sie diese Methode aufrufen.

Rückgabewert

S_OK wird zurückgegeben, wenn die Anzahl der angeforderten Elemente (celt) erfolgreich zurückgegeben wird oder die Anzahl der zurückgegebenen Elemente (pceltFetched) kleiner als die Anzahl der angeforderten Elemente ist.

Andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode	Beschreibung
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
E_OUTOFMEMORY	Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E
E_INVALIDARG	Mindestens ein Argument ist ungültig. Wert: 0x80070057

Hinweise

Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, werden die restlichen Elemente abgerufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	imapi2fs.h

Weitere Informationen

IEnumProgressItems

IEnumProgressItems::RemoteNext

Freigeben über