Share via

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에 도입됨)

추가 정보

ENCRYPTION_CERTIFICATE_HASH_LIST

파일 암호화

파일 관리 함수

FreeEncryptionCertificateHashList