FileEncryptionStatusA 関数 (winbase.h)

指定したファイルの暗号化状態を取得します。

構文

BOOL FileEncryptionStatusA(
  [in]  LPCSTR  lpFileName,
  [out] LPDWORD lpStatus
);

パラメーター

[in] lpFileName

ファイルの名前。

[out] lpStatus

ファイルの暗号化状態を受け取る変数へのポインター。 このパラメーターには、次のいずれかの値を指定できます。

価値	意味
FILE_ENCRYPTABLE 0	ファイルは暗号化できます。 Home、Home Premium、Starter、ARM Editions of Windows: FILE_ENCRYPTABLE が返される場合がありますが、EFS では、これらのエディションの Windows でのファイルの暗号化はサポートされていません。
FILE_IS_ENCRYPTED 1	ファイルは暗号化されます。
FILE_READ_ONLY 8	ファイルは読み取り専用ファイルです。
FILE_ROOT_DIR 3	ファイルはルート ディレクトリです。 ルート ディレクトリは暗号化できません。
FILE_SYSTEM_ATTR 2	ファイルはシステム ファイルです。 システム ファイルは暗号化できません。
FILE_SYSTEM_DIR 4	ファイルはシステム ディレクトリです。 システム ディレクトリは暗号化できません。
FILE_SYSTEM_NOT_SUPPORT 6	ファイル システムでは、ファイル暗号化はサポートされていません。
FILE_UNKNOWN 5	暗号化の状態が不明です。 ファイルは暗号化できます。
FILE_USER_DISALLOWED 7	将来の使用のために予約されています。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

Windows 8 および Windows Server 2012 では、この関数は次のテクノロジでサポートされています。

テクノロジー	サポート
サーバー メッセージ ブロック (SMB) 3.0 プロトコル	はい
SMB 3.0 透過的フェールオーバー (TFO)	いいえ
SMB 3.0 とスケールアウト ファイル共有 (SO)	いいえ
クラスター共有ボリューム ファイル システム (CsvFS)	いいえ
回復性のあるファイル システム (ReFS)	いいえ

 

SMB 3.0 では、継続的な可用性機能を備えた共有での EFS はサポートされていません。

手記

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FileEncryptionStatus を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winbase.h (Windows.h を含む)
ライブラリ	Advapi32.lib
DLL	Advapi32.dll

関連項目

EncryptFile

ファイル暗号化

ファイル管理機能の