IActionCollection::Remove method (taskschd.h)

Removes the specified action from the collection.

Syntax

HRESULT Remove(
  [in] VARIANT index
);

Parameters

[in] index

The index of the action to be removed. Use a LONG value for the index number.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

IActionCollection::Remove returns E_INVALIDARG and E_TYPE_MISMATCH instead of E_INVALID_VARIANT when an invalid argument is specified.

When removing items, note that the index for the first item in the collection is 1 and the index for the last item is the value of the Count property of IActionCollection.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

See also

IActionCollection

Task Scheduler