IEnumProgressItems::RemoteNext-Methode

Unterstützt einen Remoteclient, der eine angegebene Anzahl von Elementen in der Enumerationssequenz abrufen möchte.

Syntax

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

Parameter

Celt [ In]

Anzahl der abzurufende Elemente.

rgelt [ out]

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

pceltFetched [ out]

Anzahl der in rgelt zurückgegebenen Elemente. Sie können pceltFetched auf NULL festlegen, wenn celt eins ist. Andernfalls initialisieren Sie 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 einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E _ POINTER
Zeiger ist ungültig.
Wert: 0x80004003
E _ OUTOFMEMORY
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E
E _ INVALIDARG
Mindestens ein Argument ist ungültig.
Wert: 0x80070057
E _ UNEXPECTED
Unerwarteter Fehler.
Wert: 0x8000FFFF

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista, Windows XP nur mit [ SP2-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Idl
Imapi2fs.idl

Weitere Informationen

IEnumProgressItems

IEnumProgressItems::Next