Функция 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 | Да |
| Прозрачная отработка отказа (TFO) SMB 3.0 | Нет |
| SMB 3.0 с масштабируемыми общими папками (SO) | Нет |
| Файловая система общего тома кластера (CSVFS) | Нет |
| Восстанавливаемая файловая система (ReFS) | Нет |
SMB 3.0 не поддерживает EFS в общих папках с возможностью непрерывной доступности.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP Professional [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winefs.h (включая Windows.h) |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |
| Набор API | ext-ms-win-advapi32-encryptedfile-l1-1-1 (появился в Windows 10, версия 10.0.14393) |