IScheduledWorkItem::GetTriggerString 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.] ]
Retrieves a string that describes the work item trigger.
HRESULT GetTriggerString( [in] WORD iTrigger, [out] LPWSTR *ppwszTrigger );
The index of the trigger to be retrieved. The first trigger is always referenced by 0. For more information, see Remarks.
A pointer to a null-terminated string that contains the retrieved trigger description. Note that this string must be release by a call to CoTaskMemFree after the string is no longer needed.
The GetTriggerString method returns one of the following values.
||The operation was successful.|
||The arguments are not valid.|
||Not enough memory is available.|
A trigger index is not an identifier. It only indicates the trigger's position relative to the current triggers associated with the work item. For example, if you create four triggers, they will be numbered 0 through 3. But if the second trigger is deleted, the remaining triggers will be numbered 0 through 2. Note that the index of the first trigger is always 0, and the index of the last trigger is one less than the total number of triggers for the work item (TriggerCount -1).
You can retrieve the trigger count using IScheduledWorkItem::GetTriggerCount.
For an example of how to retrieve the trigger string of all triggers associated with a task, see Retrieving Trigger Strings Example.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Redistributable||Internet Explorer 4.0 or later on Windows NT 4.0 and Windows 95|