pf_opendir

The pf_opendir function opens a directory.

FRESULT pf_opendir (
  DIR* DirObject,      /* [OUT] Pointer to the blank directory object structure */
  const char* DirName  /* [IN]  Pointer to the directory name */
);

Parameters

DirObject
Pointer to the blank directory object to be created.
DirName
Pinter to the null-terminated string that specifies the directory name to be opened.

Return Values

FR_OK (0)
The function succeeded and the directory object is created. It is used for subsequent calls to read the directory entries.
FR_NO_PATH
Could not find the path.
FR_NOT_READY
The disk drive cannot work due to no medium in the drive or any other reason.
FR_DISK_ERR
The function failed due to an error in the disk function, a wrong FAT structure or an internal error.
FR_NOT_ENABLED
The volume has no work area.

Description

The pf_opendir function opens an exsisting directory and creates the directory object for subsequent calls. The directory object structure can be discarded at any time without any procedure.

QuickInfo

Available when _USE_DIR == 1.

References

f_readdir, DIR

Return