IScheduledWorkItem::GetMostRecentRunTime method (mstask.h)

  • Article

[[This API may be altered or unavailable in subsequent versions of the operating system or product. Please use the Task Scheduler 2.0 Interfaces instead.] ]

Retrieves the most recent time the work item began running.

Syntax

HRESULT GetMostRecentRunTime(
  [out] SYSTEMTIME *pstLastRun
);

Parameters

[out] pstLastRun

A pointer to a SYSTEMTIME structure that contains the most recent time the current work item ran.

Return value

The GetMostRecentRunTime method returns one of the following values.

Return code Description
S_OK
 The operation was successful.
E_INVALIDARG
 The arguments are not valid.
E_OUTOFMEMORY
 Not enough memory is available.
SCHED_S_TASK_HAS_NOT_RUN
 The work item has never run.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header mstask.h
Library Mstask.lib
DLL Mstask.dll
Redistributable Internet Explorer 4.0 or later on Windows NT 4.0 and Windows 95

See also

GetNextRunTime

IScheduledWorkItem