DuplicateEncryptionInfoFile 함수(winefs.h)
한 파일 또는 디렉터리에서 다른 파일로 EFS 메타데이터를 복사합니다.
구문
DWORD DuplicateEncryptionInfoFile(
[in] LPCWSTR SrcFileName,
[in] LPCWSTR DstFileName,
[in] DWORD dwCreationDistribution,
[in] DWORD dwAttributes,
[in, optional] const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
매개 변수
[in] SrcFileName
EFS 메타데이터를 복사할 파일 또는 디렉터리의 이름입니다. 이 원본 파일 또는 디렉터리를 암호화해야 합니다.
[in] DstFileName
EFS 메타데이터를 복사할 파일 또는 디렉터리의 이름입니다.
이 함수를 호출하기 전에 이 대상 파일 또는 디렉터리를 암호화할 필요가 없습니다. 그러나 이 함수가 성공적으로 완료되면 암호화됩니다.
SrcFileName 값이 파일을 지정하는 경우 이 매개 변수의 값도 파일을 지정해야 하며 디렉터리도 마찬가지입니다. 이 매개 변수로 지정된 이름의 파일 또는 디렉터리가 없으면 파일 또는 디렉터리( SrcFileName 에서 파일 또는 디렉터리를 지정하는지 여부에 따라 다름)가 만들어집니다.
[in] dwCreationDistribution
DstFileName 매개 변수 값으로 식별된 대상 파일 또는 디렉터리를 여는 방법을 설명합니다. 다음은 이 매개 변수의 유효한 값입니다.
값 | 의미 |
---|---|
|
항상 대상 파일 또는 디렉터리를 만듭니다. CREATE_NEW 이외의 이 매개 변수에 전달된 모든 값은 CREATE_ALWAYS 처리됩니다. |
|
대상 파일 또는 디렉터리가 아직 없는 경우에만 만듭니다. 이 값이 있고 이 값을 지정하면 이 함수가 실패합니다. |
[in] dwAttributes
대상 파일 또는 디렉터리의 파일 특성입니다. FILE_READ_ONLY 특성은 현재 이 함수에서 처리되지 않습니다.
[in, optional] lpSecurityAttributes
대상 파일 또는 디렉터리의 보안 특성을 지정하는 SECURITY_ATTRIBUTES 구조체에 대한 포인터입니다(아직 없는 경우). NULL을 지정하면 파일 또는 디렉터리가 기본 보안 설명자를 가져옵니다. 파일 또는 디렉터리에 대한 기본 보안 설명자의 ACL은 부모 디렉터리에서 상속됩니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드의 전체 목록은 시스템 오류 코드 또는 헤더 파일 WinError.h를 참조하세요.
설명
이 함수를 호출하려면 EFS에서 대상 파일 또는 디렉터리에 대한 단독 액세스가 필요합니다. 이 액세스가 제공되지 않으면 이 함수가 실패합니다.
호출자에게 원본 파일 또는 디렉터리에 대한 EFS 키와 원본 파일 또는 디렉터리에 대한 READ_ATTRIBUTE ACL이 있어야 합니다.
지정된 원본 및 대상 파일 또는 디렉터리도 동일한 컴퓨터에 있어야 합니다. 그렇지 않으면 오류가 반환됩니다.
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 |