Partager via


Méthode ITaskTrigger ::GetTriggerString (mstask.h)

[[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 .] ]

La méthode GetTriggerString récupère le déclencheur de tâche actuel sous la forme d’une chaîne. Cette chaîne apparaît dans l’interface utilisateur du planificateur de tâches sous une forme similaire à « À 14h tous les jours, à partir du 11/05/97 ».

Syntaxe

HRESULT GetTriggerString(
  [out] LPWSTR *ppwszTrigger
);

Paramètres

[out] ppwszTrigger

Pointeur vers un pointeur vers une chaîne terminée par null qui décrit le déclencheur de tâche actuel. La méthode qui appelle GetTriggerString est chargée de libérer cette chaîne à l’aide de la fonction CoTaskMemFree .

Valeur retournée

La méthode GetTriggerString 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.

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

ITaskTrigger

ITaskTrigger ::GetTrigger

ITaskTrigger ::SetTrigger