td_set_dsname
Set DS Object Name
See Also
[C Language Interface]
ER ercd = td_set_dsname ( UINT type, ID id, UB *dsname ) ;
[Parameters]
UINT type object type
ID id object ID
UB *dsname DS object name to be set
[Return Parameters]
ER ercd Error code
[Error Codes]
E_OK Normal completion
E_PAR Invalid object type
E_NOEXS Object does not exist
E_OBJ DS object name is not used
[Description]
Update DS object name (dsname), which is set at object creation. The object is specified by object type (type) and object ID (id). Object @type@s (type) are the same as that for td_ref_dsname. The DS object name needs to satisfy the following conditions but character code range is not checked by µT-Kernel.
character (UB) range: a – z, A – Z, 0 – 9
name length: 8 byte (NULL is filled if name length is less than 8 byte)
DS object name is valid if TA_DSNAME is set as object attribute. td_set_dsname() returns E_OBJ error if TA_DSNAME attribute is not specified.
Comments
Click here to Post a Comment