FSDir_Open()

FS_DIR  *FSDir_Open (CPU_CHAR  *name_full,
                     FS_ERR    *p_err);

File

Called from

Code enabled by

fs_dir.c

Application;

fs_opendir()

FS_CFG_DIR_EN

Open a directory. See fs_opendir() for more information.

Arguments

name_full

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

p_err

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

FS_ERR_NONE

Directory opened.

FS_ERR_NAME_NULL

Argument name_full passed a NULL pointer.

FS_ERR_DIR_DIS

Directory module disabled.

FS_ERR_DIR_NONE_AVAIL

No directory available.

FS_ERR_DEV

Device access error.

FS_ERR_NAME_INVALID

Entry name specified invalid or volume could not be found.

FS_ERR_NAME_PATH_TOO_LONG

Entry name is too long.

FS_ERR_VOL_NOT_OPEN

Volume not opened.

FS_ERR_VOL_NOT_MOUNTED

Volume not mounted.

FS_ERR_BUF_NONE_AVAIL

Buffer not available.

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

Returned Value

Pointer to a directory, if NO errors. Pointer to NULL, otherwise.

Notes/Warnings

None.