Функция 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)

См. также раздел

ENCRYPTION_CERTIFICATE_HASH_LIST

Шифрование файлов

Функции управления файлами

FreeEncryptionCertificateHashList