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 Normal completion

E_ID Invalid ID number (tskid is invalid or cannot be used)

E_NOEXS Object does not exist (the task specified in tskid does not exist)

E_OBJ Task does not belong to a resource group

[Description]

Returns the resource group to which the task specified in tskid currently belongs.

The invoking task can be specified 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 specified, 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.)

Comments