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 매개 변수 값으로 식별되는 대상 파일 또는 디렉터리를 여는 방법을 설명합니다. 다음은 이 매개 변수의 유효한 값입니다.

[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은 연속 가용성 기능이 있는 공유에서 EFS를 지원하지 않습니다.

요구 사항

참고 항목

파일 암호화

파일 관리 함수

SECURITY_ATTRIBUTES