DecryptFileA 関数 (winbase.h)

暗号化されたファイルまたはディレクトリの暗号化を解除します。

構文

BOOL DecryptFileA(
  [in] LPCSTR lpFileName,
       DWORD  dwReserved
);

パラメーター

[in] lpFileName

暗号化を解除するファイルまたはディレクトリの名前。

呼び出し元には、FILE_READ_DATA、FILE_WRITE_DATA、FILE_READ_ATTRIBUTES、FILE_WRITE_ATTRIBUTES、および SYNCHRONIZE アクセス権 必要があります。 詳細については、「ファイルのセキュリティとアクセス権の」を参照してください。

dwReserved

引っ込み思案;は 0 にする必要があります。

戻り値

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

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

備考

DecryptFile 関数は、復号化するファイルへの排他的アクセスを必要とし、別のプロセスでファイルを使用している場合は失敗します。 ファイルが暗号化されていない場合、DecryptFile は 0 以外の値を返します。これは成功を示します。

lpFileName 読み取り専用ファイルを指定すると、関数は失敗し、GetLastError ERROR_FILE_READ_ONLYを返します。 lpFileName が読み取り専用ファイルを含むディレクトリを指定した場合、関数は成功しますが、ディレクトリは暗号化解除されません。

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 バージョンを自動的に選択するエイリアスとして DecryptFile を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winbase.h (Windows.h を含む)
ライブラリ	Advapi32.lib
DLL	Advapi32.dll
API セットの	ext-ms-win-advapi32-encryptedfile-l1-1-0 (Windows 8 で導入)

関連項目

CreateFile の

EncryptFile

ファイル暗号化

ファイル管理機能の