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

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

Consulte también

IScheduledWorkItem