QueryRecoveryAgentsOnEncryptedFile 関数 (winefs.h)
指定したファイルの回復エージェントの一覧を取得します。
構文
DWORD QueryRecoveryAgentsOnEncryptedFile(
[in] LPCWSTR lpFileName,
[out] PENCRYPTION_CERTIFICATE_HASH_LIST *pRecoveryAgents
);
パラメーター
[in] lpFileName
ファイルの名前です。
[out] pRecoveryAgents
復旧エージェントの一覧を受け取る ENCRYPTION_CERTIFICATE_HASH_LIST 構造体へのポインター。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。
関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの完全な一覧については、「 システム エラー コード 」またはヘッダー ファイル WinError.h を参照してください。
注釈
回復エージェントの一覧が不要になったら、 FreeEncryptionCertificateHashList 関数を呼び出して解放します。
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 で導入) |