IProvideTaskPage ::GetPage, méthode (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 .] ]

Cette méthode récupère une ou plusieurs pages de feuille de propriétés associées à un objet de tâche.

Syntaxe

HRESULT GetPage(
  [in]  TASKPAGE       tpType,
  [in]  BOOL           fPersistChanges,
  [out] HPROPSHEETPAGE *phPage
);

Paramètres

[in] tpType

Une des valeurs d’énumération TASKPAGE suivantes qui spécifient la page à retourner.

TASKPAGE_TASK

Propriété de page général.

TASKPAGE_SCHEDULE

Planifiez les propriétés de la tâche.

TASKPAGE_SETTINGS

Propriétés des paramètres de la tâche.

[in] fPersistChanges

Spécifie si les modifications apportées à l’objet de tâche sont automatiquement persistantes. Si la valeur est TRUE, la page met automatiquement à jour l’objet de tâche persistant en cas de modification apportée lors de la mise en production. Si la valeur est FALSE, l’appelant est chargé d’apporter des modifications persistantes à l’objet de tâche en appelant IPersistFile ::Save sur l’objet de tâche.

[out] phPage

Gérez la page de la feuille de propriétés retournée de l’objet de tâche. Ce handle peut ensuite être utilisé pour afficher la page.

Valeur retournée

Retourne S_OK si la méthode a réussi ou STG_E_NOTFILEBASEDSTORAGE si la tâche n’a pas été enregistrée sur le disque.

Remarques

Pour récupérer l’interface IProvideTaskPage , appelez ITask ::QueryInterface.

Le code suivant montre la déclaration de variable et la syntaxe d’appel pour l’utilisation de cette méthode et pour l’appel de ITask ::QueryInterface.

Exemples

Pour obtenir un exemple complet de récupération et d’affichage de la page de tâches générales d’une tâche connue, consultez Récupérer un exemple de page de tâche

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

IProvideTaskPage

TASKPAGE