EncryptionDisable 関数 (winefs.h)

指定したディレクトリとその中のファイルの暗号化を無効または有効にします。 指定されたディレクトリの下にあるサブディレクトリの暗号化には影響しません。

構文

BOOL EncryptionDisable(
  [in] LPCWSTR DirPath,
  [in] BOOL    Disable
);

パラメーター

[in] DirPath

暗号化を有効または無効にするディレクトリの名前。

[in] Disable

暗号化を無効にするか (TRUE) 有効にするかを示します (FALSE)。

戻り値

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

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

解説

通常の状況では、 EncryptFile では 、FILE_ATTRIBUTE_SYSTEM 属性が設定されたファイルとディレクトリは暗号化されません。 FILE_ATTRIBUTE_SYSTEM属性をオーバーライドし、ファイルを暗号化できます。 また、ファイルまたはディレクトリが FILE_ATTRIBUTE_SYSTEM 属性でマークされている場合、通常、ディレクトリ一覧と Windows エクスプローラー ディレクトリ ウィンドウではユーザーには表示されません。 EncryptionDisable では、ディレクトリとファイルの暗号化が無効になります。 FILE_ATTRIBUTE_SYSTEM属性が設定されているファイルの表示には影響しません。

TRUE が渡された場合、EncryptionDisable はディレクトリ内の Desktop.ini ファイルに次のように書き込みます (必要に応じて作成します)。

[Encryption]
Disable=1

セクションが既に存在するが 、Disable が 0 に設定されている場合は、1 に設定されます。

その後、ディレクトリとその中のファイルで EncryptFile が失敗し、 GetLastError から 返されるコードが ERROR_DIR_EFS_DISALLOWEDされます。 この関数は、指定されたディレクトリ内のサブディレクトリの暗号化には影響しません。

ユーザーは、Desktop.ini ファイル内の上記の行を手動で追加または編集して、同じ効果を生成することもできます。

EncryptionDisable は、 FileEncryptionStatus と EncryptFile にのみ影響します。 ディレクトリが暗号化されると、 FILE_ATTRIBUTE_SYSTEM 属性なしで作成された新しいファイルと新しいサブディレクトリが暗号化されます。

FALSE が渡された場合、EncryptionDisable は Desktop.ini ファイルに次のように書き込みます。

[Encryption]
Disable=0

これは、そのディレクトリ内のファイルに対してファイル暗号化が許可されることを意味します。

EncryptionDisable を使用してディレクトリを既に存在する状態に設定しようとすると、関数は成功しますが、効果はありません。

EncryptionDisable を使用してファイルの暗号化を無効または有効にしようとすると、試行は失敗します。

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

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

要件

関連項目

DecryptFile

EncryptFile

ファイル属性定数

ファイルの暗号化

ファイル管理の関数

FileEncryptionStatus

GetFileAttributes