chmod.html 2.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  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_chmod</title>
  9. </head>
  10. <body>
  11. <div class="para">
  12. <h2>f_chmod</h2>
  13. <p>ファイルまたはディレクトリの属性を変更します。</p>
  14. <pre>
  15. FRESULT f_chmod (
  16. const char* <em>FileName</em>, /* ファイルまたはディレクトリ名へのポインタ */
  17. BYTE <em>Attribute</em>, /* 設定値 */
  18. BYTE <em>AttributeMask</em> /* 変更マスク */
  19. );
  20. </pre>
  21. </div>
  22. <div class="para">
  23. <h4>引数</h4>
  24. <dl class="par">
  25. <dt>FileName</dt>
  26. <dd>属性変更対象のファイルまたはディレクトリの<a href="filename.html">フルパス名</a>の入った<tt>'\0'</tt>で終わる文字列を指定します。</dd>
  27. <dt>Attribute</dt>
  28. <dd>設定する属性。指定可能な属性は次の通りで、これらの組み合わせで指定します。指定されなかった属性は解除されます。<br>
  29. <table class="lst">
  30. <tr><th>値</th><th>意味</th></td>
  31. <tr><td>AM_RDO</td><td>リード・オンリー</td></td>
  32. <tr><td>AM_ARC</td><td>アーカイブ</td></td>
  33. <tr><td>AM_SYS</td><td>システム</td></td>
  34. <tr><td>AM_HID</td><td>ヒドゥン</td></td>
  35. </table>
  36. </dd>
  37. <dt>AttributeMask</dt>
  38. <dd>変更する属性のマスク。指定した属性が設定または解除され、指定されなかった属性は状態が保持されます。<tt>Attribute</tt>と同じ値を使います。</dd>
  39. </dl>
  40. </div>
  41. <div class="para">
  42. <h4>戻り値</h4>
  43. <dl class="ret">
  44. <dt>FR_OK (0)</dt>
  45. <dd>正常終了。</dd>
  46. <dt>FR_NO_FILE</dt>
  47. <dd>ファイルが見つからない。</dd>
  48. <dt>FR_NO_PATH</dt>
  49. <dd>パスが見つからない。</dd>
  50. <dt>FR_INVALID_NAME</dt>
  51. <dd>パス名が不正。</dd>
  52. <dt>FR_INVALID_NAME</dt>
  53. <dd>ドライブ番号が不正。</dd>
  54. <dt>FR_NOT_READY</dt>
  55. <dd>メディアがセットされていないなど、ディスク・ドライブが動作不能状態。</dd>
  56. <dt>FR_WRITE_PROTECTED</dt>
  57. <dd>メディアが書き込み禁止状態。</dd>
  58. <dt>FR_RW_ERROR</dt>
  59. <dd>ディスク・エラーまたは内部エラーによる失敗。</dd>
  60. <dt>FR_NOT_ENABLED</dt>
  61. <dd>その論理ドライブにワーク・エリアが与えられていない。</dd>
  62. <dt>FR_NO_FILESYSTEM</dt>
  63. <dd>ディスク上に有効なFATパーテーションが見つからない。</dd>
  64. </dl>
  65. </div>
  66. <div class="para">
  67. <h4>解説</h4>
  68. <p>ファイルまたはディレクトリの属性を変更します。リード・オンリー構成および<tt>_FS_MINIMIZE &gt;= 1</tt>ではこの関数はサポートされません。</p>
  69. </div>
  70. <div class="para">
  71. <h4>使用例</h4>
  72. <pre>
  73. // Set read-only flag , clear archive flag and others are left unchanged.
  74. f_chmod("file.txt", AM_RDO, AM_RDO | AM_ARC);
  75. </pre>
  76. </div>
  77. <p class="foot"><a href="../00index_j.html">戻る</a></p>
  78. </body>
  79. </html>