QueryUsersOnEncryptedFile 함수(winefs.h)

사용자 목록을 검색하여 지정된 파일을 찾습니다.

구문

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 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-0(Windows 8에서 도입)

추가 정보

ENCRYPTION_CERTIFICATE_HASH_LIST

파일 암호화

파일 관리 함수

FreeEncryptionCertificateHashList