IEnumProgressItems::Next-Methode (imapi2fs.h)

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:

Hinweise

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

Anforderungen

Weitere Informationen

IEnumProgressItems

IEnumProgressItems::RemoteNext