IEnumFsiItems::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] IFsiItem **rgelt,
  [out] ULONG    *pceltFetched
);

Parameter

celt [ In]

Anzahl der abzurufenden Elemente.

rgelt [ out]

Array von IFsiItem-Schnittstellen. Wenn Sie fertig sind, müssen Sie jede Schnittstelle in rgelt wieder frei geben.

pceltFetched [ out]

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 einem Vorgangsfehler zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
_E-ZEIGER
Der 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

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

IEnumFsiItems

IEnumFsiItems::Next