SetVolumeLabelW

ファイルシステムボリュームのラベルを設定する。(Unicode)

SetVolumeLabelW lpRootPathName, lpVolumeName

lpRootPathName : [wstr] ボリュームのドライブ文字(例: X:\)またはボリュームに関連付けられたマウントフォルダのパス(例: Y:\MountX\)を含む文字列へのポインタ。文字列はバックスラッシュ ('\') で終わらなければならない。NULL を指定すると現在のディレクトリのルートが使われる。
lpVolumeName : [wstr] ボリュームの新しいラベルを含む文字列へのポインタ。NULL を指定すると、関数は指定ボリュームの既存ラベルを削除し、新ラベルは割り当てない。

(プラグイン / モジュール : kernel32.dll)

解説

ファイルシステムボリュームのラベルを設定する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
ボリュームラベルの最大長は 32 文字。FAT ファイルシステムでは最大 11
文字。ラベルはユーザーがボリュームを認識しやすくするために付ける名前で、ボリュームはラベル・ドライブ文字の両方を持つことも、どちらか・どちらも持たないこともできる。詳細は
Naming a Volume を参照。Windows 8 と Windows Server 2012
では本関数は次の技術によりサポートされる。
(以下省略)

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs