ITask::SetTaskFlags method (mstask.h)
[[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.] ]
This method sets the flags that modify the behavior of a scheduled task.
Syntax
HRESULT SetTaskFlags(
[in] DWORD dwFlags
);
Parameters
[in] dwFlags
Currently, there are no flags defined for scheduled tasks.
Return value
The SetTaskFlags method returns one of the following values.
Return code | Description |
---|---|
|
The operation was successful. |
|
The arguments are not valid. |
|
Not enough memory is available. |
Remarks
Applications must call the IPersistFile::Save method after calling SetTaskFlags to update the task flags.
This method is designed to set the flags that only apply to scheduled tasks. In contrast, IScheduledWorkItem::SetFlags is used to set the flags that apply to all types of scheduled work items.
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 |