RtfwDeleteScheduledProcessByID

RtfwDeleteScheduledProcessByID deletes the scheduled process specified by an identifier.

Syntax

Copy
bool RtfwDeleteScheduledProcessByID(
    [in]    const RTFW_SCHEDULED_ID scheduledID
);

Parameters

[in] scheduledID

Determines which scheduled process to delete. This parameter is retrieved within the structure through any get or create scheduled process function.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. Call GetLastError to obtain an error code.

Possible error codes:

Error code Meaning

ERROR_INVALID_PARAMETER

One of the parameters of this function is NULL, or a field within the structure is invalid.

RT_ERROR_STRUCTURE_TOO_SMALL

The member Size of a structure is too small.

RT_ERROR_SCHEDULED_PROCESS_LOCK_FAILURE

Failed to obtain the lock to serialize starting/stopping the wRTOS Subsystem.

RT_ERROR_SCHEDULED_PROCESS_NOT_FOUND

Failed to find a scheduled process with the given scheduledID.

Remarks

This function has locking to allow for thread safety. It shares a lock with all other scheduled process functions.

Requirements

Minimum supported version Header Library

wRTOS 1.0 SDK

RtfwApi.h

RtfwApi.lib

See Also: