Méthode IScheduledWorkItem ::GetWorkItemData (mstask.h)

  • Article

[[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 les données définies par l’application associées à l’élément de travail.

Syntaxe

HRESULT GetWorkItemData(
  [out] WORD *pcbData,
  [out] BYTE **prgbData
);

Paramètres

[out] pcbData

Pointeur vers le nombre d’octets copiés.

[out] prgbData

Pointeur vers un pointeur vers un BYTE qui contient des données définies par l’utilisateur pour l’élément de travail actuel. La méthode qui appelle GetWorkItemData est chargée de libérer cette mémoire à l’aide de CoTaskMemFree.

Valeur retournée

La méthode GetWorkItemData retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
 L'opération a réussi.
E_INVALIDARG
 Les arguments ne sont pas valides.
E_OUTOFMEMORY
 Mémoire disponible insuffisante.

Remarques

La récupération des données d’un élément de travail n’affecte en aucun cas le fonctionnement de l’élément de travail.

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

CoTaskMemFree

IScheduledWorkItem

SetWorkItemData