enumerazione KNOWN_FOLDER_FLAG (shlobj_core.h)

  • Articolo

Definisce le costanti che specificano opzioni di recupero speciali per le cartelle note , ad esempio per l'uso quando si chiama la funzione SHGetKnownFolderIDList per recuperare il percorso di una cartella nota. Questi valori sostituiscono i valori CSIDL , che hanno significati paralleli.

Sintassi

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;

Costanti

 
KF_FLAG_DEFAULT
Valore: 0x00000000
Specifica nessuna opzione di recupero speciale.
KF_FLAG_FORCE_APP_DATA_REDIRECTION
Valore: 0x00080000
Introdotta in Windows 10 versione 1709. Quando viene chiamato da un'app in pacchetto, specifica che le cartelle LocalAppData/RoamingAppData Vengono reindirizzate a percorsi di app private che corrispondono ai percorsi restituiti da Windows.Storage.ApplicationData.Current nelle proprietà LocalFolder e RoamingFolder. Altre cartelle vengono reindirizzate alle sottodirectory di LocalAppData.

Questo flag viene usato con FOLDERID_AppDataDesktop, FOLDERID_AppDataDocuments, FOLDERID_AppDataFavorites e FOLDERID_AppDataProgramData. È anche destinato alla compatibilità con le applicazioni .NET e non deve essere usato direttamente da un'applicazione.
KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET
Valore: 0x00040000
Introdotta in Windows 10 versione 1703. Quando viene eseguito in un processo in pacchetto, specifica che alcune posizioni del file system vengono reindirizzate a posizioni specifiche del pacchetto dal file system. Questo flag causa la restituzione della destinazione della direzione per tali posizioni. Questo è utile nei casi in cui la posizione reale all'interno del file system deve essere nota.
KF_FLAG_FORCE_PACKAGE_REDIRECTION
Valore: 0x00020000
Introdotta in Windows 10 versione 1703. Quando si esegue all'interno di un processo AppContainer o quando si fornisce un token AppContainer, viene specificato che alcune cartelle vengono reindirizzate a Posizioni specifiche di AppContainer all'interno del pacchetto. Questo flag forza il reindirizzamento (per le cartelle che normalmente non vengono reindirizzate) ai fini dei processi in pacchetto e può essere usato per la condivisione di file tra le app UWP e in pacchetto all'interno dello stesso pacchetto. Questo flag sostituisce la KF_FLAG_FORCE_APPCONTAINER_REDIRECTION deprecata.
KF_FLAG_NO_PACKAGE_REDIRECTION
Valore: 0x00010000
Introdotta in Windows 10 versione 1703. Quando si esegue all'interno di un processo in pacchetto o quando si specifica un token di processo in pacchetto, viene specificato che alcune cartelle vengono reindirizzate a percorsi specifici del pacchetto. Questo flag disabilita il reindirizzamento nelle posizioni in cui viene applicato e restituisce invece il percorso restituito non in esecuzione all'interno di un processo in pacchetto. Questo flag sostituisce la KF_FLAG_NO_APPCONTAINER_REDIRECTION deprecata.
KF_FLAG_FORCE_APPCONTAINER_REDIRECTION
Valore: 0x00020000
Introdotta in Windows 8. Questo flag è stato deprecato in Windows 10 versione 1703. Usare KF_FLAG_FORCE_PACKAGE_REDIRECTION invece.
KF_FLAG_NO_APPCONTAINER_REDIRECTION
Valore: 0x00010000
Introdotta in Windows 8. Questo flag è stato deprecato in Windows 10 versione 1703. Usare invece KF_FLAG_NO_PACKAGE_REDIRECTION .
KF_FLAG_CREATE
Valore: 0x00008000
Specifica per forzare la creazione della cartella specificata se tale cartella non esiste già. La sicurezza esegue il provisioning predefinito per tale cartella. Se la cartella non esiste e non può essere creata, la funzione restituisce un codice di errore e non viene restituito alcun percorso. Questo valore può essere usato solo con le funzioni e i metodi seguenti:

* SHGetKnownFolderPath
* SHGetKnownFolderIDList
* IKnownFolder::GetIDList
* IKnownFolder::GetPath
* IKnownFolder::GetShellItem
KF_FLAG_DONT_VERIFY
Valore: 0x00004000
Specifica di non verificare l'esistenza della cartella prima di tentare di recuperare il percorso o IDList. Se questo flag non è impostato, viene eseguito un tentativo di verificare che la cartella sia effettivamente presente nel percorso. Se la verifica non riesce a causa della cartella in assenza o inaccessibile, la funzione restituisce un codice di errore e non viene restituito alcun percorso.

Se la cartella si trova in una rete, la funzione potrebbe richiedere più tempo per l'esecuzione. Quindi l'impostazione di questo flag può ridurre tale latenza.
KF_FLAG_DONT_UNEXPAND
Valore: 0x00002000
Specifica per archiviare il percorso completo nel Registro di sistema senza usare le stringhe di ambiente. Se questo flag non è impostato, le parti del percorso potrebbero essere rappresentate da stringhe di ambiente, ad esempio %USERPROFILE%. Questo flag può essere usato solo con SHSetKnownFolderPath e IKnownFolder::SetPath.
KF_FLAG_NO_ALIAS
Valore: 0x00001000
Specifica per recuperare il percorso di sistema true per la cartella, senza segnaposto alias, ad esempio %USERPROFILE%, restituito da SHGetKnownFolderIDList e IKnownFolder::GetIDList. Questo flag non ha alcun effetto sui percorsi restituiti da SHGetKnownFolderPath e IKnownFolder::GetPath. Per impostazione predefinita, funzioni e metodi noti restituiscono il percorso aliasato se esiste un alias.
KF_FLAG_INIT
Valore: 0x00000800
Specifica di inizializzare la cartella usando le relative Desktop.ini impostazioni. Se la cartella non può essere inizializzata, la funzione restituisce un codice di errore e non viene restituito alcun percorso. Questo flag deve essere sempre combinato con KF_FLAG_CREATE.

Se la cartella si trova in una rete, la funzione potrebbe richiedere più tempo per l'esecuzione.
KF_FLAG_DEFAULT_PATH
Valore: 0x00000400
Specifica di recuperare il percorso predefinito per una cartella nota. Se questo flag non è impostato, la funzione recupera l'oggetto corrente, e possibilmente reindirizzato, percorso della cartella. L'esecuzione di questo flag include una verifica dell'esistenza della cartella a meno che non sia impostata KF_FLAG_DONT_VERIFY .
KF_FLAG_NOT_PARENT_RELATIVE
Valore: 0x00000200
Specifica di recuperare il percorso predefinito della cartella indipendente dalla posizione corrente del relativo padre. KF_FLAG_DEFAULT_PATH deve essere impostato anche.
KF_FLAG_SIMPLE_IDLIST
Valore: 0x00000100
Specifica la compilazione di un IDList semplice (PIDL). Questo valore può essere usato quando si vuole recuperare il percorso del file system. Tuttavia, non specificare questo valore se si recupera il nome visualizzato localizzato della cartella, perché potrebbe non essere risolto correttamente.
KF_FLAG_ALIAS_ONLY
Valore: 0x80000000
Introdotta in Windows 7. Specifica di recuperare solo i PIDL alias. Non usare il percorso del file system.

Commenti

Questi valori, ad eccezione di KF_FLAG_ALIAS_ONLY, sono stati definiti in Windows Vista come singole costanti. Sono definiti come enumerazione solo in Windows 7 e versioni successive. Tuttavia, tutti i valori numerici sottostanti sono uguali in entrambi i moduli.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione shlobj_core.h (include Shlobj.h)

Vedi anche