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 Transparent Failover (TFO)	いいえ
スケールアウト ファイル共有 (SO) を使う SMB 3.0	いいえ
クラスターの共有ボリューム ファイル システム (CsvFS)	いいえ
Resilient File System (ReFS)	いいえ

 

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

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows XP Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	winbase.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Advapi32.dll

こちらもご覧ください

EncryptFile

ファイルの暗号化

ファイル管理の関数