指定した証明書ハッシュを、指定したファイルから削除します。
構文
DWORD RemoveUsersFromEncryptedFile(
[in] LPCWSTR lpFileName,
[in] PENCRYPTION_CERTIFICATE_HASH_LIST pHashes
);
パラメーター
[in] lpFileName
ファイルの名前です。
[in] pHashes
ファイルから削除する証明書ハッシュの一覧を含む ENCRYPTION_CERTIFICATE_HASH_LIST 構造体へのポインター。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。
関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの完全な一覧については、「 システム エラー コード 」またはヘッダー ファイル WinError.h を参照してください。
注釈
RemoveUsersFromEncryptedFile 関数は、指定したファイルに存在する場合、指定した証明書ハッシュを削除します。 指定したファイルに証明書ハッシュのいずれかが見つからない場合、それらは無視され、エラー コードは返されません。
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 はサポートされていません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | winefs.h (Windows.h を含む) |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |
| API セット | ext-ms-win-advapi32-encryptedfile-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入) |