Ejemplos de propiedades de tarea de recuperación
Para recuperar las propiedades de una tarea, llame a ITaskScheduler::Activate para recuperar la interfaz del objeto de tarea y, a continuación, llame al método ITask adecuado para recuperar la propiedad de tarea que le interesa. Los ejemplos de código enumerados en la parte inferior de la página muestran cómo recuperar las distintas propiedades de la tarea.
Los ejemplos de código que aparecen en la parte inferior de la página muestran cómo recuperar las propiedades que son únicas para los objetos de tarea. Para ver otras propiedades de elemento de trabajo que también se aplican a las tareas, vea Ejemplos de recuperación de elementos de trabajo.
Nota
En el ejemplo de código siguiente, todas las interfaces se liberan después de que ya no sean necesarias.
Tenga en cuenta que si va a recuperar una propiedad de cadena (como el nombre de la aplicación, los parámetros o el directorio de trabajo), debe llamar a CoTaskMemFree para liberar la memoria asignada para la cadena devuelta.
En el procedimiento siguiente se describe cómo recuperar una propiedad de tarea.
Para recuperar una propiedad de tarea
- Llame a CoInitialize para inicializar la biblioteca COM y CoCreateInstance para obtener un objeto Task Scheduler. (En estos ejemplos se supone que el servicio Programador de tareas se está ejecutando).
- Llame a ITaskScheduler::Activate para obtener la interfaz ITask del objeto de tarea. (Tenga en cuenta que en este ejemplo se obtiene la tarea "Tarea de prueba".
- Llame al método ITask adecuado para recuperar la propiedad que le interesa.
- Procese la propiedad según sea necesario. (Estos ejemplos imprimen la propiedad en la pantalla).
- Si la propiedad devuelta es una cadena, llame a CoTaskMemFree para liberar la memoria asignada para la cadena devuelta.
| Para obtener un ejemplo de código de | Vea |
|---|---|
| Recuperar el nombre de la aplicación asociada a una tarea determinada | Ejemplo de código de C/C++: recuperación del nombre de la aplicación de tarea |
| Recuperar la cantidad máxima de tiempo que la tarea se puede ejecutar y mostrar ese número en la pantalla | Ejemplo de código de C/C++: recuperación de la tarea MaxRunTime |
| Recuperación de la cadena de parámetro que se ejecuta cuando se ejecuta la tarea y se muestra esa cadena en la pantalla | Ejemplo de código de C/C++: recuperación de parámetros de tarea |
| Recuperar el nivel de prioridad de la tarea | Ejemplo de código de C/C++: Recuperación de la prioridad de tarea |
| Recuperar el directorio de trabajo de una tarea y mostrar la ruta de acceso al directorio de trabajo en la pantalla | Ejemplo de código de C/C++: recuperación del directorio de trabajo de la tarea |
Temas relacionados