Método IScheduledWorkItem::GetExitCode (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 . ]

Recupera el último código de salida devuelto por el ejecutable asociado al elemento de trabajo en su última ejecución. El método también devuelve el código de salida devuelto al Programador de tareas cuando intentó ejecutar el elemento de trabajo por última vez.

Sintaxis

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

Parámetros

[out] pdwExitCode

Puntero a un valor DWORD que se establece en el último código de salida del elemento de trabajo. Este es el código de salida que devolvió el elemento de trabajo cuando se detuvo por última vez a ejecutarse. Si el elemento de trabajo nunca se ha iniciado, se devuelve 0.

Valor devuelto

El método GetExitCode devuelve el error del último intento de iniciar el elemento de trabajo. Estos son algunos de los valores posibles.

Código devuelto Descripción
S_OK
El intento de iniciar el elemento de trabajo se realizó correctamente.
SCHED_S_TASK_HAS_NOT_RUN
Nunca se ha intentado iniciar este elemento de trabajo.
E_INVALIDARG
Los argumentos no son válidos.
E_OUTOFMEMORY
No hay suficiente memoria disponible.

Comentarios

Este método puede devolver los dos fragmentos de información siguientes:

  • El código de error o salida devuelto por el ejecutable que se está programando se devuelve en el parámetro pdwExitCode .
  • El código de error que recibió el Programador de tareas cuando intentó iniciar el trabajo se devuelve en la propia llamada al método GetExitCode .
Para obtener un código de error actualizado, llame siempre a ITaskScheduler::Activate primero para obtener una nueva interfaz IScheduledWorkItem , que luego se puede usar para obtener los códigos de error actualizados.

Ejemplos

Para obtener un ejemplo de cómo recuperar el creador de una tarea, vea Ejemplo de código de C/C++: Recuperar código de salida de tarea.

Requisitos

   
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

Consulte también

IScheduledWorkItem