IEnumWorkItems ::Next, méthode (mstask.h)

Article
03/04/2024

[[Cette API peut être modifiée ou indisponible dans les versions ultérieures du système d’exploitation ou du produit. Utilisez plutôt les interfaces Du planificateur de tâches 2.0 .] ]

Récupère le nombre de tâches spécifié suivant dans la séquence d’énumération.

S’il reste moins que le nombre de tâches demandé dans la séquence, tous les éléments restants sont récupérés.

Syntaxe

HRESULT Next(
  [in]  ULONG  celt,
  [out] LPWSTR **rgpwszNames,
  [out] ULONG  *pceltFetched
);

Paramètres

[in] celt

Nombre de tâches à récupérer.

[out] rgpwszNames

Pointeur vers un tableau de pointeurs (LPWSTR) vers des chaînes de caractères terminées par null contenant les noms de fichiers des tâches retournées à partir de la séquence d’énumération. Ces noms de fichiers sont extraits du dossier Tâches planifiées et ont l’extension .job ».

Après avoir traité les noms retournés dans rgpwszNames, vous devez d’abord libérer chaque chaîne de caractères dans le tableau, puis le tableau lui-même à l’aide de CoTaskMemFree.

[out] pceltFetched

Pointeur vers le nombre de tâches retournées dans rgpwszNames. Si le paramètre celt est 1, ce paramètre peut avoir la valeur NULL.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Le nombre de tâches récupérées est égal au nombre demandé.
S_FALSE	Le nombre retourné est inférieur au nombre demandé. (Par conséquent, il n’y a plus de tâches à énumérer.)
E_INVALIDARG	Un paramètre n'est pas valide.
E_OUTOFMEMORY	Mémoire disponible insuffisante.

Remarques

L’interface IEnumWorkItems fournit également des méthodes pour réinitialiser l’énumération, ignorer les tâches et effectuer une copie de l’état actuel de l’énumération.

Exemples

Pour obtenir un exemple d’utilisation de next pour énumérer les tâches dans le dossier Tâches planifiées, consultez Exemple d’énumération de tâches.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mstask.h
Bibliothèque	Mstask.lib
DLL	Mstask.dll
Composant redistribuable	Internet Explorer 4.0 ou version ultérieure sur Windows NT 4.0 et Windows 95

Voir aussi

IEnumWorkItems

IEnumWorkItems ::Clone

IEnumWorkItems ::Reset

IEnumWorkItems ::Skip