KNOWN_FOLDER_FLAG-Enumeration (shlobj_core.h)

  • Artikel

Definiert Konstanten, die spezielle Abrufoptionen für bekannte Ordner angeben (z. B. für die Verwendung beim Aufrufen der SHGetKnownFolderIDList-Funktion zum Abrufen des Pfads eines bekannten Ordners). Diese Werte ersetzen CSIDL-Werte , die parallele Bedeutungen aufweisen.

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;

Konstanten

 
KF_FLAG_DEFAULT
Wert: 0x00000000
Gibt keine besonderen Abrufoptionen an.
KF_FLAG_FORCE_APP_DATA_REDIRECTION
Wert: 0x00080000
Eingeführt in Windows 10 Version 1709. Gibt beim Aufruf aus einer gepackten App an, dass LocalAppData/RoamingAppData-Ordner an private App-Speicherorte umgeleitet werden, die den Pfaden entsprechen, die von Windows.Storage.ApplicationData.Current in den Eigenschaften LocalFolder und RoamingFolder zurückgegeben werden. Andere Ordner werden zu Unterverzeichnissen von LocalAppData umgeleitet.

Dieses Flag wird mit FOLDERID_AppDataDesktop, FOLDERID_AppDataDocuments, FOLDERID_AppDataFavorites und FOLDERID_AppDataProgramData verwendet. Es ist auch für die Kompatibilität mit .NET-Anwendungen vorgesehen und nicht für die direkte Verwendung aus einer Anwendung vorgesehen.
KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET
Wert: 0x00040000
Eingeführt in Windows 10 Version 1703. Gibt bei der Ausführung in einem gepackten Prozess an, dass einige Dateisystemspeicherorte vom Dateisystem an paketspezifische Speicherorte umgeleitet werden. Dieses Flag bewirkt, dass das Ziel der Richtung für diese Standorte zurückgegeben wird. Dies ist nützlich, wenn der tatsächliche Speicherort im Dateisystem bekannt sein muss.
KF_FLAG_FORCE_PACKAGE_REDIRECTION
Wert: 0x00020000
Eingeführt in Windows 10 Version 1703. Gibt beim Ausführen innerhalb eines AppContainer-Prozesses oder beim Bereitstellen eines AppContainer-Tokens an, dass einige Ordner an AppContainer-spezifische Speicherorte innerhalb des Pakets umgeleitet werden. Dieses Flag erzwingt die Umleitung (für Ordner, die normalerweise nicht umgeleitet werden) für gepackte Prozesse und kann zum Freigeben von Dateien zwischen UWP und gepackten Apps innerhalb desselben Pakets verwendet werden. Dieses Flag ersetzt die veraltete KF_FLAG_FORCE_APPCONTAINER_REDIRECTION.
KF_FLAG_NO_PACKAGE_REDIRECTION
Wert: 0x00010000
Eingeführt in Windows 10 Version 1703. Gibt beim Ausführen in einem verpackten Prozess oder beim Bereitstellen eines gepackten Prozesstokens an, dass einige Ordner an paketspezifische Speicherorte umgeleitet werden. Dieses Flag deaktiviert die Umleitung an Speicherorten, an denen es angewendet wird, und gibt stattdessen den Pfad zurück, der zurückgegeben wird, wenn er nicht in einem gepackten Prozess ausgeführt wird. Dieses Flag ersetzt die veraltete KF_FLAG_NO_APPCONTAINER_REDIRECTION.
KF_FLAG_FORCE_APPCONTAINER_REDIRECTION
Wert: 0x00020000
In Windows 8 eingeführt. Dieses Flag war in Windows 10 Version 1703 veraltet. Verwenden Sie stattdessen KF_FLAG_FORCE_PACKAGE_REDIRECTION .
KF_FLAG_NO_APPCONTAINER_REDIRECTION
Wert: 0x00010000
In Windows 8 eingeführt. Dieses Flag war in Windows 10 Version 1703 veraltet. Verwenden Sie stattdessen KF_FLAG_NO_PACKAGE_REDIRECTION .
KF_FLAG_CREATE
Wert: 0x00008000
Gibt an, die Erstellung des angegebenen Ordners zu erzwingen, wenn dieser Ordner noch nicht vorhanden ist. Die für diesen Ordner vordefinierten Sicherheitsbestimmungen werden angewendet. Wenn der Ordner nicht vorhanden ist und nicht erstellt werden kann, gibt die Funktion einen Fehlercode zurück, und es wird kein Pfad zurückgegeben. Dieser Wert kann nur mit den folgenden Funktionen und Methoden verwendet werden:

* SHGetKnownFolderPath
* SHGetKnownFolderIDList
* IKnownFolder::GetIDList
* IKnownFolder::GetPath
* IKnownFolder::GetShellItem
KF_FLAG_DONT_VERIFY
Wert: 0x00004000
Gibt an, die Existenz des Ordners nicht zu überprüfen, bevor versucht wird, den Pfad oder die IDList abzurufen. Wenn dieses Flag nicht festgelegt ist, wird versucht, zu überprüfen, ob der Ordner im Pfad wirklich vorhanden ist. Wenn bei dieser Überprüfung ein Fehler auftritt, weil der Ordner nicht vorhanden ist oder nicht zugegriffen werden kann, gibt die Funktion einen Fehlercode zurück, und es wird kein Pfad zurückgegeben.

Wenn sich der Ordner in einem Netzwerk befindet, dauert die Ausführung der Funktion möglicherweise länger. Das Festlegen dieses Flags kann also diese Latenz verringern.
KF_FLAG_DONT_UNEXPAND
Wert: 0x00002000
Gibt an, den vollständigen Pfad in der Registrierung zu speichern, ohne Umgebungszeichenfolgen zu verwenden. Wenn dieses Flag nicht festgelegt ist, werden Teile des Pfads möglicherweise durch Umgebungszeichenfolgen wie %USERPROFILE%dargestellt. Dieses Flag kann nur mit SHSetKnownFolderPath und IKnownFolder::SetPath verwendet werden.
KF_FLAG_NO_ALIAS
Wert: 0x00001000
Gibt an, den wahren Systempfad für den Ordner abzurufen, frei von aliasierten Platzhaltern wie %USERPROFILE%, zurückgegeben von SHGetKnownFolderIDList und IKnownFolder::GetIDList. Dieses Flag hat keine Auswirkungen auf Pfade, die von SHGetKnownFolderPath und IKnownFolder::GetPath zurückgegeben werden. Standardmäßig geben bekannte Ordnerabruffunktionen und -methoden den Aliaspfad zurück, wenn ein Alias vorhanden ist.
KF_FLAG_INIT
Wert: 0x00000800
Gibt an, dass der Ordner mithilfe seiner Desktop.ini Einstellungen initialisiert werden soll. Wenn der Ordner nicht initialisiert werden kann, gibt die Funktion einen Fehlercode zurück, und es wird kein Pfad zurückgegeben. Dieses Flag sollte immer mit KF_FLAG_CREATE kombiniert werden.

Wenn sich der Ordner in einem Netzwerk befindet, dauert die Ausführung der Funktion möglicherweise länger.
KF_FLAG_DEFAULT_PATH
Wert: 0x00000400
Gibt an, den Standardpfad für einen bekannten Ordner abzurufen. Wenn dieses Flag nicht festgelegt ist, ruft die Funktion den aktuellen - und möglicherweise umgeleiteten - Pfad des Ordners ab. Die Ausführung dieses Flags umfasst eine Überprüfung der Existenz des Ordners, es sei denn , KF_FLAG_DONT_VERIFY festgelegt ist.
KF_FLAG_NOT_PARENT_RELATIVE
Wert: 0x00000200
Gibt an, dass der Standardpfad des Ordners unabhängig vom aktuellen Speicherort des übergeordneten Ordners abgerufen werden soll. KF_FLAG_DEFAULT_PATH muss ebenfalls festgelegt werden.
KF_FLAG_SIMPLE_IDLIST
Wert: 0x00000100
Gibt an, eine einfache IDList (PIDL) zu erstellen. Dieser Wert kann verwendet werden, wenn Sie den Dateisystempfad abrufen möchten. Geben Sie diesen Wert jedoch nicht an, wenn Sie den lokalisierten Anzeigenamen des Ordners abrufen, da er möglicherweise nicht ordnungsgemäß aufgelöst wird.
KF_FLAG_ALIAS_ONLY
Wert: 0x80000000
In Windows 7 eingeführt. Gibt an, nur aliasierte PIDLs abzurufen. Verwenden Sie nicht den Dateisystempfad.

Hinweise

Diese Werte, mit Ausnahme von KF_FLAG_ALIAS_ONLY, wurden in Windows Vista als einzelne Konstanten definiert. Sie werden nur in Windows 7 und höher als Enumeration definiert. Alle zugrunde liegenden numerischen Werte sind jedoch in beiden Formen identisch.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)

Weitere Informationen