FSEntry_AttribSet()

void  FSEntry_AttribSet (CPU_CHAR  *name_full,
                         FS_FLAGS   attrib,
                         FS_ERR    *p_err);

Set a file or directory’s attributes.

Arguments

name_full

Name of the entry. See the sub-topic "µC/FS File and Directory Names and Paths" in the topic Useful Information.

attrib

Entry attributes to set (see Note #2).

p_err

Pointer to variable that will the receive return error code from this function:

FS_ERR_NONE

Entry attributes set successfully.

FS_ERR_NAME_NULL

Argument name_full passed a NULL pointer.

FS_ERR_NAME_INVALID

Entry name specified invalid OR volume could not be found.

FS_ERR_NAME_PATH_TOO_LONG

Entry name specified too long.

FS_ERR_VOL_NOT_OPEN

Volume was not open.

FS_ERR_VOL_NOT_MOUNTED

Volume was not mounted.

FS_ERR_BUF_NONE_AVAIL

Buffer not available.

FS_ERR_DEV

Device access error.

Or entry error (See µC/FS Error Codes).

Returned Value

None.

Notes/Warnings

1. If the entry does not exist, an error is returned.

2. Three attributes may be modified by this function:

   FS_ENTRY_ATTRIB_RD	Entry is readable.
   FS_ENTRY_ATTRIB_WR	Entry is writable.
   FS_ENTRY_ATTRIB_HIDDEN	Entry is hidden from user-level processes.

   An attribute will be cleared if its flag is not OR’d into attrib. An attribute will be set if its flag is OR’d into attrib. If another flag besides these are set, then an error will be returned.

3. The attributes of the root directory may not be set.