enumeración KNOWN_FOLDER_FLAG (shlobj_core.h)

  • Artículo

Define constantes que especifican opciones de recuperación especiales para carpetas conocidas (por ejemplo, para usarlas al llamar a la función SHGetKnownFolderIDList para recuperar la ruta de acceso de una carpeta conocida). Estos valores reemplazan a los valores CSIDL , que tienen significados paralelos.

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;

Constantes

 
KF_FLAG_DEFAULT
Valor: 0x00000000
Especifica ninguna opción de recuperación especial.
KF_FLAG_FORCE_APP_DATA_REDIRECTION
Valor: 0x00080000
Introducido en Windows 10, versión 1709. Cuando se llama desde una aplicación empaquetada, especifica que las carpetas LocalAppData/RoamingAppData se redirigen a ubicaciones de aplicaciones privadas que coinciden con las rutas de acceso devueltas desde Windows.Storage.ApplicationData.Current en las propiedades LocalFolder y RoamingFolder . Otras carpetas se redirigen a subdirectorios de LocalAppData.

Esta marca se usa con FOLDERID_AppDataDesktop, FOLDERID_AppDataDocuments, FOLDERID_AppDataFavorites y FOLDERID_AppDataProgramData. También está pensado para la compatibilidad con aplicaciones .NET y no está diseñado para usarse directamente desde una aplicación.
KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET
Valor: 0x00040000
Se introdujo en Windows 10, versión 1703. Cuando se ejecuta en un proceso empaquetado, especifica que el sistema de archivos redirige algunas ubicaciones del sistema de archivos a ubicaciones específicas del paquete. Esta marca hace que el destino de la dirección se devuelva para esas ubicaciones. Esto es útil en los casos en los que es necesario conocer la ubicación real dentro del sistema de archivos.
KF_FLAG_FORCE_PACKAGE_REDIRECTION
Valor: 0x00020000
Se introdujo en Windows 10, versión 1703. Cuando se ejecuta dentro de un proceso de AppContainer o al proporcionar un token de AppContainer, especifica que algunas carpetas se redirigen a ubicaciones específicas de AppContainer dentro del paquete. Esta marca fuerza el redireccionamiento (para las carpetas que normalmente no se redirigen) con fines de procesos empaquetados, y se puede usar para compartir archivos entre UWP y aplicaciones empaquetadas dentro del mismo paquete. Esta marca sustituye al KF_FLAG_FORCE_APPCONTAINER_REDIRECTION en desuso.
KF_FLAG_NO_PACKAGE_REDIRECTION
Valor: 0x00010000
Se introdujo en Windows 10, versión 1703. Cuando se ejecuta dentro de un proceso empaquetado o al proporcionar un token de proceso empaquetado, especifica que algunas carpetas se redirigen a ubicaciones específicas del paquete. Esta marca deshabilita el redireccionamiento en ubicaciones donde se aplica y, en su lugar, devuelve la ruta de acceso que se devolvería si no se ejecutaba dentro de un proceso empaquetado. Esta marca reemplaza al KF_FLAG_NO_APPCONTAINER_REDIRECTION en desuso.
KF_FLAG_FORCE_APPCONTAINER_REDIRECTION
Valor: 0x00020000
Introducido en Windows 8. Esta marca está en desuso en Windows 10, versión 1703. Use KF_FLAG_FORCE_PACKAGE_REDIRECTION en su lugar.
KF_FLAG_NO_APPCONTAINER_REDIRECTION
Valor: 0x00010000
Introducido en Windows 8. Esta marca está en desuso en Windows 10, versión 1703. En su lugar, use KF_FLAG_NO_PACKAGE_REDIRECTION .
KF_FLAG_CREATE
Valor: 0x00008000
Especifica para forzar la creación de la carpeta especificada si esa carpeta aún no existe. Se aplican las disposiciones de seguridad predefinidas para esa carpeta. Si la carpeta no existe y no se puede crear, la función devuelve un código de error y no se devuelve ninguna ruta de acceso. Este valor solo se puede usar con las siguientes funciones y métodos:

* SHGetKnownFolderPath
* SHGetKnownFolderIDList
* IKnownFolder::GetIDList
* IKnownFolder::GetPath
* IKnownFolder::GetShellItem
KF_FLAG_DONT_VERIFY
Valor: 0x00004000
Especifica no comprobar la existencia de la carpeta antes de intentar recuperar la ruta de acceso o IDList. Si no se establece esta marca, se intenta comprobar que la carpeta está realmente presente en la ruta de acceso. Si se produce un error en esa comprobación debido a que la carpeta no está presente o no es accesible, la función devuelve un código de error y no se devuelve ninguna ruta de acceso.

Si la carpeta se encuentra en una red, la función puede tardar más tiempo en ejecutarse. Por lo tanto, establecer esta marca puede reducir esa latencia.
KF_FLAG_DONT_UNEXPAND
Valor: 0x00002000
Especifica para almacenar la ruta de acceso completa en el registro sin usar cadenas de entorno. Si no se establece esta marca, es posible que las partes de la ruta de acceso se representen mediante cadenas de entorno como %USERPROFILE%. Esta marca solo se puede usar con SHSetKnownFolderPath e IKnownFolder::SetPath.
KF_FLAG_NO_ALIAS
Valor: 0x00001000
Especifica que se recupere la ruta de acceso del sistema verdadera para la carpeta, sin ningún marcador de posición con alias, como %USERPROFILE%, devuelto por SHGetKnownFolderIDList e IKnownFolder::GetIDList. Esta marca no tiene ningún efecto en las rutas de acceso devueltas por SHGetKnownFolderPath e IKnownFolder::GetPath. De forma predeterminada, las funciones y métodos conocidos de recuperación de carpetas devuelven la ruta de acceso con alias si existe un alias.
KF_FLAG_INIT
Valor: 0x00000800
Especifica que se inicialice la carpeta con su Desktop.ini configuración. Si la carpeta no se puede inicializar, la función devuelve un código de error y no se devuelve ninguna ruta de acceso. Esta marca siempre debe combinarse con KF_FLAG_CREATE.

Si la carpeta se encuentra en una red, la función puede tardar más tiempo en ejecutarse.
KF_FLAG_DEFAULT_PATH
Valor: 0x00000400
Especifica para recuperar la ruta de acceso predeterminada de una carpeta conocida. Si no se establece esta marca, la función recupera la ruta de acceso actual (y posiblemente redirigida) de la carpeta. La ejecución de esta marca incluye una comprobación de la existencia de la carpeta a menos que se establezca KF_FLAG_DONT_VERIFY .
KF_FLAG_NOT_PARENT_RELATIVE
Valor: 0x00000200
Especifica para recuperar la ruta de acceso predeterminada de la carpeta independientemente de la ubicación actual de su elemento primario. KF_FLAG_DEFAULT_PATH también se debe establecer.
KF_FLAG_SIMPLE_IDLIST
Valor: 0x00000100
Especifica para compilar un IDList simple (PIDL). Este valor se puede usar cuando desea recuperar la ruta de acceso del sistema de archivos. Pero no especifique este valor si va a recuperar el nombre para mostrar localizado de la carpeta, ya que es posible que no se resuelva correctamente.
KF_FLAG_ALIAS_ONLY
Valor: 0x80000000
Se introdujo en Windows 7. Especifica que solo se recuperan los PIN con alias. No use la ruta de acceso del sistema de archivos.

Comentarios

Estos valores, a excepción de KF_FLAG_ALIAS_ONLY, se definieron en Windows Vista como constantes individuales. Se definen como una enumeración solo en Windows 7 y versiones posteriores. Sin embargo, todos los valores numéricos subyacentes son los mismos en cualquier forma.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado shlobj_core.h (incluya Shlobj.h)

Consulte también