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_ALWAYS 2	항상 대상 파일 또는 디렉터리를 만듭니다. CREATE_NEW 이외의 이 매개 변수에 전달된 모든 값은 CREATE_ALWAYS 처리됩니다.
CREATE_NEW 1	대상 파일 또는 디렉터리가 아직 없는 경우에만 만듭니다. 이 값이 있고 이 값을 지정하면 이 함수가 실패합니다.

[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

추가 정보

파일 암호화

파일 관리 함수

SECURITY_ATTRIBUTES