1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
5 <meta http-equiv=
"Content-Style-Type" content=
"text/css">
6 <link rel=
"up" title=
"FatFs" href=
"../00index_j.html">
7 <link rel=
"alternate" hreflang=
"en" title=
"English" href=
"../en/setlabel.html">
8 <link rel=
"stylesheet" href=
"../css_j.css" type=
"text/css" media=
"screen" title=
"ELM Default">
9 <title>FatFs - f_setlabel
</title>
14 <div class=
"para func">
16 <p>ボリュームにボリューム ラベルを設定します。
</p>
19 const TCHAR*
<span class=
"arg">label
</span> <span class=
"c">/* [IN] 設定するボリューム ラベルへのポインタ */
</span>
24 <div class=
"para arg">
28 <dd>設定するボリューム ラベルを示すヌル文字
<tt>'\
0'
</tt>終端の文字列へのポインタを指定します。
</dd>
33 <div class=
"para ret">
36 <a href=
"rc.html#ok">FR_OK
</a>,
37 <a href=
"rc.html#de">FR_DISK_ERR
</a>,
38 <a href=
"rc.html#ie">FR_INT_ERR
</a>,
39 <a href=
"rc.html#nr">FR_NOT_READY
</a>,
40 <a href=
"rc.html#in">FR_INVALID_NAME
</a>,
41 <a href=
"rc.html#wp">FR_WRITE_PROTECTED
</a>,
42 <a href=
"rc.html#id">FR_INVALID_DRIVE
</a>,
43 <a href=
"rc.html#ne">FR_NOT_ENABLED
</a>,
44 <a href=
"rc.html#ns">FR_NO_FILESYSTEM
</a>,
45 <a href=
"rc.html#tm">FR_TIMEOUT
</a>
50 <div class=
"para desc">
52 <p>文字列の先頭にドライブ番号を含む場合は、その論理ドライブに対して設定されます。含まない場合は、デフォルト ドライブに設定されます。ボリューム ラベルを削除するときは、ヌル文字列を指定します。ボリューム ラベルのフォーマットは、ファイル名(SFN)とほぼ同じですが、次の点が異なります。
</p>
54 <li>ローカル文字コード換算で
11バイト以下。LFN拡張は適用されません。
</li>
55 <li>ピリオドを含むことはできない。
</li>
56 <li>任意の位置にスペースを置くことができる。ただし、最後尾となるスペースは除去される。
</li>
60 <div class=
"para comp">
62 <p><tt>_FS_READONLY ==
0</tt>で、且つ
<tt>_USE_LABEL ==
1</tt>のときに使用可能です。
</p>
66 <div class=
"para use">
69 <span class=
"c">/* デフォルト ドライブにボリューム ラベルを設定 */
</span>
70 f_setlabel(
"DATA DISK");
72 <span class=
"c">/* ドライブ
2にボリューム ラベルを設定 */
</span>
73 f_setlabel(
"2:DISK 3 OF 4");
75 <span class=
"c">/* ドライブ
2のボリューム ラベルを削除 */
</span>
81 <div class=
"para ref">
83 <tt><a href=
"getlabel.html">f_getlabel
</a></tt>
87 <p class=
"foot"><a href=
"../00index_j.html">戻る
</a></p>