ITaskSettings::AllowHardTerminate property

Gets or sets a Boolean value that indicates that the task may be terminated by the Task Scheduler service using TerminateProcess. The service will try to close the running task by sending the WM_CLOSE notification, and if the task does not respond, the task will be terminated only if this property is set to true.

This property is read/write.

Syntax


HRESULT put_AllowHardTerminate(
  [in]  VARIANT_BOOL allowHardTerminate
);

HRESULT get_AllowHardTerminate(
  [out] VARIANT_BOOL *pAllowHardTerminate
);

Property value

A Boolean value that indicates that the task may be terminated by using TerminateProcess.

Error codes

NameMeaning
S_OK

The property value was successfully set or retrieved.

Remarks

When reading or writing XML for a task, this setting is specified in the AllowHardTerminate element of the Task Scheduler schema.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Taskschd.h

Library

Taskschd.lib

DLL

Taskschd.dll

See also

ITaskSettings
TaskSettings
Task Scheduler
ITaskSettings

 

 

Show: