SetFileInformationByHandle

指定したファイルのファイル情報を設定する。

SetFileInformationByHandle hFile, FileInformationClass, lpFileInformation, dwBufferSize

hFile : [intptr] 情報を変更するファイルへのハンドル。このハンドルは要求する変更に適した権限で開かれている必要がある。詳細は備考およびサンプルコードを参照。パイプハンドルであってはならない。
FileInformationClass : [int] 変更する情報の種類を指定する FILE_INFO_BY_HANDLE_CLASS 列挙値。有効な値の表は備考を参照。
lpFileInformation : [intptr] 指定したファイル情報クラスに対して変更する情報を含むバッファへのポインタ。このパラメータが指す構造体は FileInformationClass で指定したクラスに対応する。有効な構造体型の表は備考を参照。
dwBufferSize : [int] lpFileInformation のサイズ (バイト単位)。

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

解説

指定したファイルのファイル情報を設定する。

[戻り値]
成功した場合は非ゼロ、そうでない場合はゼロを返す。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
一部のファイル情報クラスは OS
リリースによって挙動がわずかに異なる。これらのクラスは基礎となるドライバでサポートされており、返される情報は OS
リリース間で変更される可能性がある。この関数で使用する有効なファイル情報クラスと対応するデータ構造体型を次の表に示す。
(以下省略)

情報

プラグイン / モジュール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