IEnumTASK::Next, méthode (mmc.h)

Article
08/24/2023

La méthode IEnumTASK::Next permet à MMC de récupérer la tâche suivante dans la liste des tâches du composant logiciel enfichable.

Syntaxe

HRESULT Next(
  [in]  ULONG    celt,
  [out] MMC_TASK *rgelt,
  [out] ULONG    *pceltFetched
);

Paramètres

[in] celt

Valeur qui spécifie le nombre de tâches à fournir. MMC énumère toujours les tâches une par une ; par conséquent, le celte est toujours 1.

[out] rgelt

Pointeur vers une structure MMC_TASK que le composant logiciel enfichable remplit pour représenter la tâche à ajouter au bloc-tâches. N’oubliez pas que l’appelant (MMC) alloue la mémoire pour la structure.

[out] pceltFetched

Pointeur vers une valeur qui spécifie le nombre de tâches retournées. Si le composant logiciel enfichable a correctement retourné une ou plusieurs tâches, définissez la valeur sur le nombre de tâches retournées avec succès. Étant donné que MMC demande toujours une tâche à la fois (celt est toujours 1), pceltFetched doit être défini sur 1 si la tâche a été retournée avec succès. Si le composant logiciel enfichable n’a plus de tâches dans sa liste, ou si le composant logiciel enfichable ne parvient pas à remplir la structure MMC_TASK, définissez la valeur sur 0.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

MMC appelle cette méthode pour énumérer la liste des tâches que le composant logiciel enfichable doit ajouter au bloc-tâches. MMC appelle cette méthode jusqu’à ce qu’elle retourne S_FALSE pour indiquer qu’il n’y a plus de tâches à ajouter au composant logiciel enfichable.