Método IProvideTaskPage::GetPage (mstask.h)
[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o producto. Use en su lugar las interfaces del Programador de tareas 2.0 . ]
Este método recupera una o varias páginas de hoja de propiedades asociadas a un objeto de tarea.
Sintaxis
HRESULT GetPage(
[in] TASKPAGE tpType,
[in] BOOL fPersistChanges,
[out] HPROPSHEETPAGE *phPage
);
Parámetros
[in] tpType
Uno de los siguientes valores de enumeración TASKPAGE que especifican la página que se va a devolver.
TASKPAGE_TASK
Propiedad de página general.
TASKPAGE_SCHEDULE
Programe las propiedades de la tarea.
TASKPAGE_SETTINGS
Propiedades de configuración de la tarea.
[in] fPersistChanges
Especifica si los cambios realizados en el objeto de tarea se realizan automáticamente. Si es TRUE, la página actualiza automáticamente el objeto de tarea persistente si se realiza un cambio en la versión. Si es FALSE, el autor de la llamada es responsable de realizar cambios de objeto de tarea persistentes mediante una llamada a IPersistFile::Save en el objeto de tarea.
[out] phPage
Identificador de la página de hoja de propiedades devuelta del objeto de tarea. Después, este identificador se puede usar para mostrar la página.
Valor devuelto
Devuelve S_OK si el método se realizó correctamente o STG_E_NOTFILEBASEDSTORAGE si la tarea no se ha guardado en el disco.
Comentarios
Para recuperar la interfaz IProvideTaskPage , llame a ITask::QueryInterface.
El código siguiente muestra la declaración de variable y la sintaxis de llamada para usar este método y para llamar a ITask::QueryInterface.
Ejemplos
Para obtener un ejemplo completo de cómo recuperar y mostrar la página de tareas general de una tarea conocida, vea Ejemplo de recuperación de una página de tareas.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mstask.h |
| Library | Mstask.lib |
| Archivo DLL | Mstask.dll |
| Redistribuible | Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95 |