T-Kernel Specification (1.B0.02)

4.1. TASK MANAGEMENT FUNCTIONS 43
tk get rid
Get Task Resource ID
[C Language Interface]
ID resid = tk_get_rid ( ID tskid ) ;
[Parameters]
ID tskid Task ID
[Return Parameters]
ID resid Resource ID
or Error Code
[Error Codes]
E OK
E ID
E NOEXS
E OBJ
Normal completion
Invalid ID number (tskid is invalid or cannot be used)
Object does not exist (the task designated in tskid does not exist)
Task does not belong to a resource group
[Description]
Returns the resource group to which the task designated in tskid currently belongs.
The invoking task can be designated by setting tskid = TSK SELF = 0. Note, however, that when a
system call is issued from a task-independent portion and tskid = TSK SELF = 0 is designated, error
code E ID is returned.
[Additional Notes]
If a resource group is deleted, this system call may return the resource ID of the deleted resource group.
Whether or not an error code (E OBJ) is returned is implementation-dependent. (See tk cre res,
tk del res.)
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02