EncryptionDisable 함수(winefs.h)

아티클
08/27/2023

지정된 디렉터리와 해당 디렉터리에 암호화를 사용하거나 사용하지 않도록 설정합니다. 표시된 디렉터리 아래의 하위 디렉터리 암호화에는 영향을 주지 않습니다.

구문

BOOL EncryptionDisable(
  [in] LPCWSTR DirPath,
  [in] BOOL    Disable
);

매개 변수

[in] DirPath

암호화를 사용하거나 사용하지 않도록 설정할 디렉터리의 이름입니다.

[in] Disable

암호화를 사용하지 않도록 설정할지(TRUE) 또는 사용하도록 설정할지(FALSE)를 나타냅니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

정상적인 상황에서 EncryptFile 은 FILE_ATTRIBUTE_SYSTEM 특성 집합을 사용하여 파일 및 디렉터리를 암호화하지 않습니다. FILE_ATTRIBUTE_SYSTEM 특성을 재정의하고 파일을 암호화할 수 있습니다. 또한 파일 또는 디렉터리가 FILE_ATTRIBUTE_SYSTEM 특성으로 표시된 경우 일반적으로 디렉터리 목록 및 Windows Explorer 디렉터리 창에서 사용자에게 표시되지 않습니다. EncryptionDisable 은 디렉터리 및 파일의 암호화를 사용하지 않도록 설정합니다. FILE_ATTRIBUTE_SYSTEM 특성이 설정된 파일의 표시 유형에는 영향을 주지 않습니다.

TRUE가 전달되면 EncryptionDisable은 디렉터리의 Desktop.ini 파일에 다음을 씁니다(필요한 경우 생성).

[Encryption]
Disable=1

섹션이 이미 있지만 Disable 가 0으로 설정된 경우 1로 설정됩니다.

그 후 EncryptFile 은 디렉터리와 디렉터리의 파일에서 실패하고 GetLastError 가 반환하는 코드는 ERROR_DIR_EFS_DISALLOWED. 이 함수는 지정된 디렉터리 내의 하위 디렉터리 암호화에 영향을 주지 않습니다.

사용자는 Desktop.ini 파일에서 위의 줄을 수동으로 추가하거나 편집하여 동일한 효과를 생성할 수도 있습니다.

EncryptionDisable 은 FileEncryptionStatus 및 EncryptFile에만 영향을 줍니다. 디렉터리가 암호화되면 FILE_ATTRIBUTE_SYSTEM 특성 없이 만든 새 파일 및 새 하위 디렉터리가 암호화됩니다.

FALSE가 전달되면 EncryptionDisable은 Desktop.ini 파일에 다음을 씁니다.

[Encryption]
Disable=0

즉, 해당 디렉터리의 파일에서 파일 암호화가 허용됩니다.

EncryptionDisable을 사용하여 디렉터리를 이미 있는 상태로 설정하려고 하면 함수가 성공하지만 아무런 효과가 없습니다.

EncryptionDisable을 사용하여 파일에서 암호화를 사용하지 않도록 설정하거나 사용하도록 설정하려고 하면 시도가 실패합니다.

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