KNOWN_FOLDER_FLAG 열거형(shlobj_core.h)

  • 아티클

알려진 폴더에 대한 특수 검색 옵션을 지정하는 상수를 정의합니다(예: 알려진 폴더의 경로를 검색하기 위해 SHGetKnownFolderIDList 함수를 호출할 때 사용). 이러한 값은 병렬 의미가 있는 CSIDL 값을 대체합니다.

Syntax

typedef enum {
  KF_FLAG_DEFAULT = 0x00000000,
  KF_FLAG_FORCE_APP_DATA_REDIRECTION = 0x00080000,
  KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET = 0x00040000,
  KF_FLAG_FORCE_PACKAGE_REDIRECTION = 0x00020000,
  KF_FLAG_NO_PACKAGE_REDIRECTION = 0x00010000,
  KF_FLAG_FORCE_APPCONTAINER_REDIRECTION = 0x00020000,
  KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x00010000,
  KF_FLAG_CREATE = 0x00008000,
  KF_FLAG_DONT_VERIFY = 0x00004000,
  KF_FLAG_DONT_UNEXPAND = 0x00002000,
  KF_FLAG_NO_ALIAS = 0x00001000,
  KF_FLAG_INIT = 0x00000800,
  KF_FLAG_DEFAULT_PATH = 0x00000400,
  KF_FLAG_NOT_PARENT_RELATIVE = 0x00000200,
  KF_FLAG_SIMPLE_IDLIST = 0x00000100,
  KF_FLAG_ALIAS_ONLY = 0x80000000
} KNOWN_FOLDER_FLAG;

상수

 
KF_FLAG_DEFAULT
값: 0x00000000
특수 검색 옵션을 지정하지 않습니다.
KF_FLAG_FORCE_APP_DATA_REDIRECTION
값: 0x00080000
Windows 10 버전 1709에 도입되었습니다. 패키지된 앱에서 호출되는 경우 LocalAppData/RoamingAppData 폴더가 LocalFolder 및 RoamingFolder 속성의 Windows.Storage.ApplicationData.Current에서 반환된 경로와 일치하는 프라이빗 앱 위치로 리디렉션되도록 지정합니다. 다른 폴더는 LocalAppData의 하위 디렉터리로 리디렉션됩니다.

이 플래그는 FOLDERID_AppDataDesktop, FOLDERID_AppDataDocuments, FOLDERID_AppDataFavorites 및 FOLDERID_AppDataProgramData 함께 사용됩니다. 또한 .NET 애플리케이션과의 호환성을 위한 것이며 애플리케이션에서 직접 사용할 수 없습니다.
KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET
값: 0x00040000
Windows 10 버전 1703에 도입되었습니다. 패키지된 프로세스에서 실행하는 경우 일부 파일 시스템 위치가 파일 시스템에 의해 패키지별 위치로 리디렉션되도록 지정합니다. 이 플래그를 사용하면 방향의 대상이 해당 위치에 대해 반환됩니다. 이는 파일 시스템 내의 실제 위치를 알려야 하는 경우에 유용합니다.
KF_FLAG_FORCE_PACKAGE_REDIRECTION
값: 0x00020000
Windows 10 버전 1703에 도입되었습니다. AppContainer 프로세스 내에서 실행하거나 AppContainer 토큰을 제공할 때 일부 폴더가 패키지 내의 AppContainer 관련 위치로 리디렉션되도록 지정합니다. 이 플래그는 패키지된 프로세스의 목적에 따라 리디렉션(일반적으로 리디렉션되지 않는 폴더의 경우)을 강제로 적용하며, 동일한 패키지 내에서 UWP와 패키지된 앱 간에 파일을 공유하는 데 사용할 수 있습니다. 이 플래그는 사용되지 않는 KF_FLAG_FORCE_APPCONTAINER_REDIRECTION 대체합니다.
KF_FLAG_NO_PACKAGE_REDIRECTION
값: 0x00010000
Windows 10 버전 1703에 도입되었습니다. 패키지된 프로세스 내에서 실행하거나 패키지된 프로세스 토큰을 제공할 때 일부 폴더가 패키지별 위치로 리디렉션되도록 지정합니다. 이 플래그는 적용된 위치에서 리디렉션을 사용하지 않도록 설정하고, 패키지된 프로세스 내에서 실행되지 않는 경우 반환될 경로를 반환합니다. 이 플래그는 사용되지 않는 KF_FLAG_NO_APPCONTAINER_REDIRECTION 대체합니다.
KF_FLAG_FORCE_APPCONTAINER_REDIRECTION
값: 0x00020000
Windows 8 도입되었습니다. 이 플래그는 Windows 10 버전 1703에서 더 이상 사용되지 않습니다. 대신 KF_FLAG_FORCE_PACKAGE_REDIRECTION 사용합니다.
KF_FLAG_NO_APPCONTAINER_REDIRECTION
값: 0x00010000
Windows 8 도입되었습니다. 이 플래그는 Windows 10 버전 1703에서 더 이상 사용되지 않습니다. 대신 KF_FLAG_NO_PACKAGE_REDIRECTION 사용합니다.
KF_FLAG_CREATE
값: 0x00008000
해당 폴더가 아직 없는 경우 지정된 폴더를 강제로 만들도록 지정합니다. 해당 폴더에 대해 미리 정의된 보안 프로비저닝이 적용됩니다. 폴더가 없고 만들 수 없는 경우 함수는 실패 코드를 반환하고 경로가 반환되지 않습니다. 이 값은 다음 함수 및 메서드에서만 사용할 수 있습니다.

* SHGetKnownFolderPath
* SHGetKnownFolderIDList
* IKnownFolder::GetIDList
* IKnownFolder::GetPath
* IKnownFolder::GetShellItem
KF_FLAG_DONT_VERIFY
값: 0x00004000
경로 또는 IDList를 검색하기 전에 폴더의 존재를 확인하지 않도록 지정합니다. 이 플래그가 설정되지 않은 경우 폴더가 경로에 실제로 있는지 확인하려고 시도합니다. 폴더가 없거나 액세스할 수 없어서 확인이 실패하면 함수는 실패 코드를 반환하고 경로는 반환되지 않습니다.

폴더가 네트워크에 있는 경우 함수를 실행하는 데 시간이 더 오래 걸릴 수 있습니다. 따라서 이 플래그를 설정하면 대기 시간을 줄일 수 있습니다.
KF_FLAG_DONT_UNEXPAND
값: 0x00002000
환경 문자열을 사용하지 않고 레지스트리에 전체 경로를 저장하는 사양입니다. 이 플래그를 설정하지 않으면 경로의 일부가 와 같은 %USERPROFILE%환경 문자열로 표시될 수 있습니다. 이 플래그는 SHSetKnownFolderPath 및 IKnownFolder::SetPath에서만 사용할 수 있습니다.
KF_FLAG_NO_ALIAS
값: 0x00001000
SHGetKnownFolderIDList 및 IKnownFolder::GetIDList에서 반환된 와 같은 %USERPROFILE%별칭이 지정된 자리 표시자가 없는 폴더의 실제 시스템 경로를 검색하도록 지정합니다. 이 플래그는 SHGetKnownFolderPath 및 IKnownFolder::GetPath에서 반환되는 경로에 영향을 주지 않습니다. 기본적으로 알려진 폴더 검색 함수 및 메서드는 별칭이 있는 경우 별칭이 지정된 경로를 반환합니다.
KF_FLAG_INIT
값: 0x00000800
설정을 사용하여 폴더를 초기화하도록 지정합니다 Desktop.ini . 폴더를 초기화할 수 없는 경우 함수는 실패 코드를 반환하고 경로가 반환되지 않습니다. 이 플래그는 항상 KF_FLAG_CREATE 함께 사용해야 합니다.

폴더가 네트워크에 있는 경우 함수를 실행하는 데 시간이 더 오래 걸릴 수 있습니다.
KF_FLAG_DEFAULT_PATH
값: 0x00000400
알려진 폴더의 기본 경로를 검색하도록 지정합니다. 이 플래그가 설정되지 않은 경우 함수는 폴더의 현재 경로와 리디렉션된 경로를 검색합니다. 이 플래그의 실행에는 KF_FLAG_DONT_VERIFY 설정되지 않은 한 폴더의 존재 확인이 포함됩니다.
KF_FLAG_NOT_PARENT_RELATIVE
값: 0x00000200
부모의 현재 위치와 관계없이 폴더의 기본 경로를 검색하도록 지정합니다. KF_FLAG_DEFAULT_PATH 설정해야 합니다.
KF_FLAG_SIMPLE_IDLIST
값: 0x00000100
간단한 IDList(PIDL)를 빌드하도록 지정합니다. 이 값은 파일 시스템 경로를 검색하려는 경우에 사용할 수 있습니다. 그러나 폴더의 지역화된 표시 이름을 검색하는 경우 올바르게 resolve 않을 수 있으므로 이 값을 지정하지 마세요.
KF_FLAG_ALIAS_ONLY
값: 0x80000000
Windows 7에 도입되었습니다. 별칭이 지정된 PIDL만 검색하도록 지정합니다. 파일 시스템 경로를 사용하지 마세요.

설명

이러한 값은 KF_FLAG_ALIAS_ONLY 제외하고 Windows Vista에서 개별 상수로 정의되었습니다. Windows 7 이상에서만 열거형으로 정의됩니다. 그러나 모든 기본 숫자 값은 두 형식에서 동일합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글 shlobj_core.h(Shlobj.h 포함)

추가 정보