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 |
|---|---|
|
Zeiger ist ungültig. Wert: 0x80004003 |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E |
|
Mindestens ein Argument ist ungültig. Wert: 0x80070057 |
|
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 |
|