SetFileAttributesFromAppW 함수(fileapifromapp.h)

파일 또는 디렉터리의 특성을 설정합니다. 이 함수는 유니버설 Windows 플랫폼 앱 보안 모델을 준수한다는 점을 제외하고 이 함수의 동작은 SetFileAttributes와 동일합니다.

구문

WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
  LPCWSTR lpFileName,
  DWORD   dwFileAttributes
) noexcept;

매개 변수

lpFileName

특성을 설정할 파일의 이름입니다.

"\\?\" 앞에 추가하지 않고 MAX_PATH 제한을 옵트아웃하는 방법에 대한 자세한 내용은 파일, 경로 및 네임스페이스의 "최대 경로 길이 제한" 섹션을 참조하세요.

dwFileAttributes

파일에 대해 설정할 파일 특성입니다.

이 매개 변수는 비트 OR 연산자를 사용하여 결합된 하나 이상의 값일 수 있습니다. 그러나 다른 모든 값은 FILE_ATTRIBUTE_NORMAL 재정의합니다.

이 함수에서 모든 특성이 지원되는 것은 아닙니다.

다음은 지원되는 특성 값 목록입니다.

값	의미
FILE_ATTRIBUTE_ARCHIVE 32(0x20)	보관 파일 또는 디렉터리인 파일 또는 디렉터리입니다. 애플리케이션은 일반적으로 이 특성을 사용하여 백업 또는 제거를 위해 파일을 표시합니다.
FILE_ATTRIBUTE_HIDDEN 2(0x2)	파일 또는 디렉터리가 숨겨져 있으며 일반 디렉터리 목록에 포함되지 않습니다.
FILE_ATTRIBUTE_NORMAL 128(0x80)	다른 특성이 설정되지 않은 파일입니다. 이 특성은 단독으로 사용될 때만 유효합니다.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192(0x2000)	파일 또는 디렉터리가 콘텐츠 인덱싱 서비스에서 인덱싱되지 않습니다.
FILE_ATTRIBUTE_OFFLINE 4096(0x1000)	파일의 데이터를 즉시 사용할 수 없습니다. 이 특성은 파일 데이터가 오프라인 스토리지로 물리적으로 이동되었음을 나타냅니다. 이 특성은 계층적 스토리지 관리 소프트웨어인 원격 스토리지에서 사용됩니다. 애플리케이션이 이 특성을 임의로 변경해서는 안 됩니다.
FILE_ATTRIBUTE_READONLY 1(0x1)	읽기 전용인 파일입니다. 애플리케이션은 파일을 읽을 수 있지만 파일에 쓰거나 파일을 삭제할 수 없습니다. 이 특성은 디렉터리에 적용되지 않습니다.
FILE_ATTRIBUTE_SYSTEM 4(0x4)	운영 체제가 일부를 사용하거나 독점적으로 사용하는 파일 또는 디렉터리입니다.
FILE_ATTRIBUTE_TEMPORARY 256(0x100)	임시 스토리지에 사용되는 파일입니다. 일반적으로 애플리케이션은 핸들이 닫힌 후 임시 파일을 삭제하므로 충분한 캐시 메모리를 사용할 수 있는 경우 파일 시스템은 데이터를 대용량 스토리지에 다시 쓰지 않도록 합니다. 이 시나리오에서 시스템은 데이터 쓰기를 완전히 방지할 수 있습니다. 그러지 않으면 핸들이 닫힌 후 데이터가 기록됩니다.

반환 값

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

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

요구 사항

지원되는 최소 클라이언트	Windows 10, 버전 1803
머리글	fileapifromapp.h