Функция pf_opendir открывает директорию.

FRESULT pf_opendir (
  DIR* DirObject,      /* Указатель на пустую структуру объекта директории */
  const char* DirName  /* Указатель на имя директории */
);

Параметры

DirObject

Указатель на чистую структуру объекта директории (blank directory object), которая будет заполнена информацией после вызова функции.

DirName

Указатель на null-terminated (завершенную нулем) строку, которая содержит имя открываемой директории.

Возвращаемые значения

FR_OK (0)

Функция успешно завершилась, и был создан объект директории. Далее объект директории может быть использован в вызовах функции чтения объектов директории pf_readdir.

FR_NO_PATH

Путь не найден.

FR_NOT_READY

Привод диска неработоспособен либо из-за отсутствия в диске носителя данных (no medium) или по любой другой причине.

FR_DISK_ERR

Функция завершилась неудачно из-за ошибки в работе диска, испорченной структуры FAT или из-за внутренней ошибки.

FR_NOT_ENABLED

Том не имеет рабочей области (не смонтирован).

Описание

Функция pf_opendir открывает существующую директорию и создает (заполняет) объект директории для последующих обращений к нему. Структура объекта директории может быть отброшена в любой момент без вызова какой-либо специальной процедуры.

Краткая информация (QuickInfo)

Функция доступна, когда _USE_DIR == 1.

См. также

pf_readdir, DIR