// ------------------------------------------------------------------------------
// <auto-generated>
//     This code was generated by a tool.
//
//     Changes to this file may cause incorrect behavior and will be lost if
//     the code is regenerated.
// </auto-generated>
// ------------------------------------------------------------------------------

#pragma warning disable CS1591,CS1573,CS0465,CS0649,CS8019,CS1570,CS1584,CS1658,CS0436,CS8981
using global::System;
using global::System.Diagnostics;
using global::System.Diagnostics.CodeAnalysis;
using global::System.Runtime.CompilerServices;
using global::System.Runtime.InteropServices;
using global::System.Runtime.Versioning;
using winmdroot = global::Windows.Win32;
namespace Windows.Win32
{
	namespace UI.Shell
	{
		/// <summary>Defines constants that specify special retrieval options for known folders. These values supersede CSIDL values, which have parallel meanings.</summary>
		/// <remarks>These values, with the exception of **KF_FLAG_ALIAS_ONLY**, were defined in Windows Vista as individual constants. They're defined as an enumeration only in Windows 7 and later. However, all underlying numerical values are the same in either form.</remarks>
		[Flags]
		[global::System.CodeDom.Compiler.GeneratedCode("Microsoft.Windows.CsWin32", "0.3.151+58e949951d.RR")]
		internal enum KNOWN_FOLDER_FLAG
		{
			/// <summary>Specifies no special retrieval options.</summary>
			KF_FLAG_DEFAULT = 0x00000000,
			/// <summary>
			/// <para>**Introduced in Windows 10, version 1709**. When called from a packaged app, specifies that **LocalAppData**/**RoamingAppData** folders are redirected to private app locations that match the paths returned from [Windows.Storage.ApplicationData.Current](/uwp/api/windows.storage.applicationdata.current) in the **LocalFolder** and **RoamingFolder** properties. Other folders are redirected to subdirectories of **LocalAppData**. This flag is used with **FOLDERID_AppDataDesktop**, **FOLDERID_AppDataDocuments**, **FOLDERID_AppDataFavorites**, and **FOLDERID_AppDataProgramData**. It's also intended for compatibility with .NET applications, and not meant to be used directly from an application.</para>
			/// <para><see href="https://learn.microsoft.com/windows/win32/api/shlobj_core/ne-shlobj_core-known_folder_flag#members">Read more on docs.microsoft.com</see>.</para>
			/// </summary>
			KF_FLAG_FORCE_APP_DATA_REDIRECTION = 0x00080000,
			/// <summary>**Introduced in Windows 10, version 1703**. When running in a packaged process, specifies that some file system locations are redirected to package-specific locations by the file system. This flag causes the target of the direction to be returned for those locations. This is useful in cases where the real location within the file system needs to be known.</summary>
			KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET = 0x00040000,
			/// <summary>**Introduced in Windows 10, version 1703**. When running inside an AppContainer process, or when providing an AppContainer token, specifies that some folders are redirected to AppContainer-specific locations within the package. This flag forces redirection (for folders that aren't normally redirected) for the purposes of packaged processes, and can be used for sharing files between UWP and packaged apps within the same package. This flag supersedes the deprecated **KF_FLAG_FORCE_APPCONTAINER_REDIRECTION**.</summary>
			KF_FLAG_FORCE_PACKAGE_REDIRECTION = 0x00020000,
			/// <summary>**Introduced in Windows 10, version 1703**. When running inside a packaged process, or when providing a packaged process token, specifies that some folders are redirected to package-specific locations. This flag disables redirection on locations where it's applied, and instead returns the path that would be returned were it not running inside a packaged process. This flag supersedes the deprecated **KF_FLAG_NO_APPCONTAINER_REDIRECTION**.</summary>
			KF_FLAG_NO_PACKAGE_REDIRECTION = 0x00010000,
			/// <summary>**Introduced in Windows 8**. This flag was deprecated in Windows 10, version 1703. Use **KF_FLAG_FORCE_PACKAGE_REDIRECTION** instead.</summary>
			KF_FLAG_FORCE_APPCONTAINER_REDIRECTION = 0x00020000,
			/// <summary>**Introduced in Windows 8**. This flag was deprecated in Windows 10, version 1703. Use **KF_FLAG_NO_PACKAGE_REDIRECTION** instead.</summary>
			KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x00010000,
			/// <summary>
			/// <para>Specifies to force the creation of the specified folder if that folder doesn't already exist. The security provisions predefined for that folder are applied. If the folder doesn't exist and can't be created, then the function returns a failure code, and no path is returned. This value can be used only with the following functions and methods: * [SHGetKnownFolderPath](/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath) * [SHGetKnownFolderIDList](/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderidlist) * [IKnownFolder::GetIDList](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iknownfolder-getidlist) * [IKnownFolder::GetPath](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iknownfolder-getpath) * [IKnownFolder::GetShellItem](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iknownfolder-getshellitem)</para>
			/// <para><see href="https://learn.microsoft.com/windows/win32/api/shlobj_core/ne-shlobj_core-known_folder_flag#members">Read more on docs.microsoft.com</see>.</para>
			/// </summary>
			KF_FLAG_CREATE = 0x00008000,
			/// <summary>
			/// <para>Specifies not to verify the folder's existence before attempting to retrieve the path or IDList. If this flag isn't set, then an attempt is made to verify that the folder is truly present at the path. If that verification fails due to the folder being absent or inaccessible, then the function returns a failure code, and no path is returned. If the folder is located on a network, then the function might take longer to execute. So setting this flag can reduce that latency.</para>
			/// <para><see href="https://learn.microsoft.com/windows/win32/api/shlobj_core/ne-shlobj_core-known_folder_flag#members">Read more on docs.microsoft.com</see>.</para>
			/// </summary>
			KF_FLAG_DONT_VERIFY = 0x00004000,
			/// <summary>Specfies to store the full path in the registry without using environment strings. If this flag isn't set, then portions of the path might be represented by environment strings such as `%USERPROFILE%`. This flag can be used only with [SHSetKnownFolderPath](/windows/win32/api/shlobj_core/nf-shlobj_core-shsetknownfolderpath) and [IKnownFolder::SetPath](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iknownfolder-setpath).</summary>
			KF_FLAG_DONT_UNEXPAND = 0x00002000,
			/// <summary>Specifies to retrieve the true system path for the folder, free of any aliased placeholders such as `%USERPROFILE%`, returned by [SHGetKnownFolderIDList](/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderidlist) and [IKnownFolder::GetIDList](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iknownfolder-getidlist). This flag has no effect on paths returned by [SHGetKnownFolderPath](/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath) and [IKnownFolder::GetPath](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iknownfolder-getpath). By default, known folder retrieval functions and methods return the aliased path if an alias exists.</summary>
			KF_FLAG_NO_ALIAS = 0x00001000,
			/// <summary>
			/// <para>Specifies to initialize the folder using its `Desktop.ini` settings. If the folder can't be initialized, then the function returns a failure code, and no path is returned. This flag should always be combined with **KF_FLAG_CREATE**. If the folder is located on a network, then the function might take longer to execute.</para>
			/// <para><see href="https://learn.microsoft.com/windows/win32/api/shlobj_core/ne-shlobj_core-known_folder_flag#members">Read more on docs.microsoft.com</see>.</para>
			/// </summary>
			KF_FLAG_INIT = 0x00000800,
			/// <summary>Specifies to retrieve the default path for a known folder. If this flag isn't set, then the function retrieves the current&mdash;and possibly redirected&mdash;path of the folder. The execution of this flag includes a verification of the folder's existence unless **KF_FLAG_DONT_VERIFY** is set.</summary>
			KF_FLAG_DEFAULT_PATH = 0x00000400,
			/// <summary>Specifies to retrieve the folder's default path independent of the current location of its parent. **KF_FLAG_DEFAULT_PATH** must also be set.</summary>
			KF_FLAG_NOT_PARENT_RELATIVE = 0x00000200,
			/// <summary>Specifies to build a simple IDList (PIDL). This value can be used when you want to retrieve the file system path. But don't specify this value if you're retrieving the localized display name of the folder, because it might not resolve correctly.</summary>
			KF_FLAG_SIMPLE_IDLIST = 0x00000100,
			/// <summary>**Introduced in Windows 7**. Specifies to retrieve only aliased PIDLs. Don't use the file system path.</summary>
			KF_FLAG_ALIAS_ONLY = unchecked((int)0x80000000),
		}
	}
}