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