opendir.html 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
  2. <html lang="ja">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
  5. <meta http-equiv="Content-Style-Type" content="text/css">
  6. <link rel="up" title="FatFs" href="../00index_j.html">
  7. <link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
  8. <title>FatFs - f_opendir</title>
  9. </head>
  10. <body>
  11. <div class="para">
  12. <h2>f_opendir</h2>
  13. <p>ディレクトリをオープンします。</p>
  14. <pre>
  15. FRESULT f_opendir (
  16. DIR* <em>DirObject</em>, /* ディレクトリ・ブジェクト構造体へのポインタ */
  17. const char* <em>DirName</em> /* ディレクトリ名へのポインタ */
  18. );
  19. </pre>
  20. </div>
  21. <div class="para">
  22. <h4>引数</h4>
  23. <dl class="par">
  24. <dt>DirObject</dt>
  25. <dd>初期化するディレクトリ・オブジェクト構造体へのポインタを指定します。</dd>
  26. <dt>DirName</dt>
  27. <dd>オープンするディレクトリの<a href="filename.html">フルパス名</a>が入った<tt>'\0'</tt>で終わる文字列へのポインタを指定します。</dd>
  28. </dl>
  29. </div>
  30. <div class="para">
  31. <h4>戻り値</h4>
  32. <dl class="ret">
  33. <dt>FR_OK (0)</dt>
  34. <dd>正常終了。</dd>
  35. <dt>FR_NO_FILE</dt>
  36. <dd>ディレクトリが見つからない。</dd>
  37. <dt>FR_NO_PATH</dt>
  38. <dd>パスが見つからない。</dd>
  39. <dt>FR_INVALID_NAME</dt>
  40. <dd>パス名が不正。</dd>
  41. <dt>FR_INVALID_DRIVE</dt>
  42. <dd>ドライブ番号が不正。</dd>
  43. <dt>FR_NOT_READY</dt>
  44. <dd>メディアがセットされていないなど、ディスク・ドライブが動作不能状態。</dd>
  45. <dt>FR_RW_ERROR</dt>
  46. <dd>ディスク・エラーまたは内部エラーによる失敗。</dd>
  47. <dt>FR_NOT_ENABLED</dt>
  48. <dd>論理ドライブにワーク・エリアが与えられていない。</dd>
  49. <dt>FR_NO_FILESYSTEM</dt>
  50. <dd>ディスク上に有効なFATパーテーションが見つからない。</dd>
  51. </dl>
  52. </div>
  53. <div class="para">
  54. <h4>解説</h4>
  55. <p>ディレクトリをオープンします。正常終了したら、<tt>DirObject</tt>構造体を使ってこのディレクトリの項目を順次読み出せます。<tt>DirObject</tt>構造体は使用後は任意の時点で破棄できます。<tt>_FS_MINIMIZE >= 2</tt>ではこの関数はサポートされません。</p>
  56. </div>
  57. <div class="para">
  58. <h4>参照</h4>
  59. <p><tt><a href="readdir.html">f_readdir</a>, <a href="sdir.html">DIR</a></tt></p>
  60. </div>
  61. <p class="foot"><a href="../00index_j.html">戻る</a></p>
  62. </body>
  63. </html>