td_set_dsname

Set DS Object Name

[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 types (type) are as same as that of td_ref_dsname(). 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 .lled 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