Recuperar ejemplos de propiedades de elemento de trabajo
Para recuperar las propiedades de un elemento de trabajo, llame a ITaskScheduler::Activate para recuperar la interfaz del objeto de elemento de trabajo y, a continuación, llame al método adecuado para recuperar la propiedad de tarea que le interesa. Actualmente, los únicos elementos de trabajo válidos son tareas.
Los ejemplos de código enumerados en la parte inferior de esta página muestran cómo recuperar las propiedades que se aplican a todos los elementos de trabajo. Para ver otras propiedades que son exclusivas de las tareas, vea Establecer ejemplos de propiedades de tarea.
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 (por ejemplo, comentario para un elemento 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 las tareas son actualmente el único tipo válido de elemento de trabajo).
- Llame al método adecuado para recuperar la propiedad que le interesa.
- Procese la propiedad según sea necesario. (Estos ejemplos simplemente 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 la información de la cuenta de una tarea conocida | Ejemplo de código de C/C++: recuperar información de la cuenta de tarea |
| Recuperación de la cadena de comentario de una tarea conocida | Ejemplo de código de C/C++: recuperar un comentario de tarea |
| Recuperar el nombre del creador de la tarea y mostrarlo en la pantalla | Ejemplo de código de C/C++: recuperación del creador de tareas |
| Recuperar el último código de salida devuelto por una tarea conocida | Ejemplo de código de C/C++: recuperar código de salida de tarea |
| Recuperar el tiempo de espera de inactividad de la tarea y mostrarlo en la pantalla | Ejemplo de código de C/C++: Recuperación del tiempo de espera de inactividad de la tarea |
| Recuperar la hora en que se ejecutó por última vez la tarea y mostrarla en la pantalla | Ejemplo de código de C/C++: recuperar la hora mostrecentrun de la tarea |
| Recuperar la próxima vez que se programe la tarea para ejecutarse y mostrar esa hora en la pantalla | Ejemplo de código de C/C++: recuperar la hora de siguiente ejecución de la tarea |
| Recuperar los tiempos de ejecución de la tarea y mostrarlos en la pantalla | Ejemplo de código de C/C++: recuperación de tiempos de ejecución de tareas |
| Recuperar el estado actual de la tarea y mostrarlo en la pantalla | Ejemplo de código de C/C++: recuperar el estado de la tarea |
Temas relacionados