IEnumProgressItems::RemoteNext, méthode

Article
06/12/2023

Prend en charge un client distant qui souhaite récupérer un nombre spécifié d’éléments dans la séquence d’énumération

Syntaxe

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

Paramètres

celte [in]: Nombre d’éléments à récupérer.
rgelt [out]: Tableau d’interfaces IProgressItem . Vous devez libérer chaque interface dans rgelt lorsque vous avez terminé.
pceltFetched [out]: Nombre d’éléments retournés dans rgelt. Vous pouvez définir pceltFetched sur NULL si celt est un. Sinon, initialisez la valeur de pceltFetched sur 0 avant d’appeler cette méthode.

Valeur retournée

S_OK est retourné lorsque le nombre d’éléments demandés (celte) est retourné avec succès ou que le nombre d’éléments retournés (pceltFetched) est inférieur au nombre d’éléments demandés.

D’autres codes de réussite peuvent être retournés suite à l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour	Description
E_POINTER	Le pointeur n’est pas valide. Valeur : 0x80004003
E_OUTOFMEMORY	Échec de l’allocation de la mémoire requise. Valeur : 0x8007000E
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides. Valeur : 0x80070057
E_UNEXPECTED	Une défaillance inattendue s'est produite. Valeur : 0x8000FFFF

Notes

S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
IDL	Imapi2fs.idl

Voir aussi

IEnumProgressItems
IEnumProgressItems::Next

Partager via