指定したファイルのユーザーの一覧を取得します。
構文
DWORD QueryUsersOnEncryptedFile(
[in] LPCWSTR lpFileName,
[out] PENCRYPTION_CERTIFICATE_HASH_LIST *pUsers
);
パラメーター
[in] lpFileName
ファイルの名前です。
[out] pUsers
ユーザーの一覧を受け取る 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-0 (Windows 8 で導入) |