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 프로토콜 | Yes |
| SMB 3.0 TFO(투명 장애 조치(failover)) | No |
| SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 | No |
| CsvFS(클러스터 공유 볼륨 파일 시스템) | No |
| ReFS(Resilient File System) | No |
SMB 3.0은 연속 가용성 기능이 있는 공유에서 EFS를 지원하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winefs.h(Windows.h 포함) |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |
| API 세트 | ext-ms-win-advapi32-encryptedfile-l1-1-1(Windows 10 버전 10.0.14393에 도입됨) |