SetFileAttributesFromAppW 関数 (fileapifromapp.h)

ファイルまたはディレクトリの属性を設定します。 この関数の動作は SetFileAttributes と同じですが、この関数はユニバーサル Windows プラットフォームアプリ セキュリティ モデルに準拠している点が異なります。

構文

WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
  LPCWSTR lpFileName,
  DWORD   dwFileAttributes
) noexcept;

パラメーター

lpFileName

属性を設定するファイルの名前。

前もって "\\?\" を指定せずに MAX_PATH 制限をオプトアウトする方法については、「 名前付けファイル、パス、および名前空間 」の「パスの最大長制限」セクションを参照してください。

dwFileAttributes

ファイルに設定するファイル属性。

このパラメーターには、ビットごとの OR 演算子を使用して組み合わせた 1 つ以上の値を指定できます。 ただし、他のすべての値 はFILE_ATTRIBUTE_NORMALをオーバーライドします。

この関数では、すべての属性がサポートされているわけではありません。

サポートされている属性値の一覧を次に示します。

値	意味
FILE_ATTRIBUTE_ARCHIVE 32 (0x20)	アーカイブ ファイルまたはディレクトリであるファイルまたはディレクトリ。 アプリケーションでは通常、この属性を使用して、バックアップまたは削除のためにファイルをマークします。
FILE_ATTRIBUTE_HIDDEN 2 (0x2)	ファイルまたはディレクトリは非表示です。 通常のディレクトリ一覧には含まれません。
FILE_ATTRIBUTE_NORMAL 128 (0x80)	他の属性が設定されていないファイル。 この属性は、単独で使った場合にのみ有効です。
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000)	ファイルまたはディレクトリには、コンテンツ インデックス サービスによってインデックスが付けられません。
FILE_ATTRIBUTE_OFFLINE 4096 (0x1000)	ファイルのデータはすぐに使用できません。 この属性は、ファイル データが物理的にオフライン ストレージに移動されたことを示します。 この属性はリモート記憶域 (階層型ストレージ管理ソフトウェア) によって使われます。 アプリケーションはこの属性を任意に変更しないでください。
FILE_ATTRIBUTE_READONLY 1 (0x1)	読み取り専用のファイル。 アプリケーションはこのファイルを読み取ることができますが、書き込んだり削除したりすることはできません。 この属性は、ディレクトリでは無視されます。
FILE_ATTRIBUTE_SYSTEM 4 (0x4)	オペレーティング システムがその一部を使う、または排他的に使うファイルまたはディレクトリ。
FILE_ATTRIBUTE_TEMPORARY 256 (0x100)	一時的なストレージとして使われているファイル。 十分なキャッシュ メモリを使用できる場合、ファイル システムは大容量記憶装置へのデータの書き戻しを回避します。なぜなら、通常はハンドルが閉じられると、アプリケーションは一時ファイルを削除するからです。 このようなシナリオでは、システムはデータの書き込みを完全に回避できます。 それ以外の場合は、ハンドルが閉じられた後にデータが書き込まれます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

サポートされている最小のクライアント	Windows 10 バージョン 1803
Header	fileapifromapp.h