Share via

_KF_REDIRECT_FLAGS-Enumeration (shobjidl_core.h)

  • Artikel

Flags, die von IKnownFolderManager::Redirect verwendet werden, um Details einer bekannten Ordnerumleitung anzugeben, z. B. Berechtigungen und Besitzrechte für den umgeleiteten Ordner.

Syntax

typedef enum _KF_REDIRECT_FLAGS {
  KF_REDIRECT_USER_EXCLUSIVE = 0x1,
  KF_REDIRECT_COPY_SOURCE_DACL = 0x2,
  KF_REDIRECT_OWNER_USER = 0x4,
  KF_REDIRECT_SET_OWNER_EXPLICIT = 0x8,
  KF_REDIRECT_CHECK_ONLY = 0x10,
  KF_REDIRECT_WITH_UI = 0x20,
  KF_REDIRECT_UNPIN = 0x40,
  KF_REDIRECT_PIN = 0x80,
  KF_REDIRECT_COPY_CONTENTS = 0x200,
  KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x400,
  KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x800
} ;

Konstanten

 
KF_REDIRECT_USER_EXCLUSIVE
Wert: 0x1
Stellen Sie sicher, dass nur der Benutzer über die Berechtigung für den Zugriff auf den umgeleiteten Ordner verfügt.
KF_REDIRECT_COPY_SOURCE_DACL
Wert: 0x2
Kopieren Sie die DACL des Quellordners in das Ziel, um die aktuellen Zugriffsberechtigungen beizubehalten.
KF_REDIRECT_OWNER_USER
Wert: 0x4
Legt den Benutzer als Besitzer eines neu erstellten Zielordners fest, es sei denn, der Benutzer ist Mitglied der Administratorgruppe. In diesem Fall wird Administrator als Besitzer festgelegt. Muss mit KF_REDIRECT_SET_OWNER_EXPLICIT aufgerufen werden.
KF_REDIRECT_SET_OWNER_EXPLICIT
Wert: 0x8
Legen Sie den Besitzer eines neu erstellten Zielordners fest. Wenn der Benutzer zur Gruppe Administratoren gehört, werden Administratoren als Besitzer zugewiesen. Muss mit KF_REDIRECT_OWNER_USER aufgerufen werden.
KF_REDIRECT_CHECK_ONLY
Wert: 0x10
Führen Sie keine Umleitung durch, sondern überprüfen Sie einfach, ob eine Umleitung erfolgt ist. Wenn ja, gibt IKnownFolderManager::Redirect S_OK zurück. andernfalls oder wenn einige Aktionen noch abgeschlossen werden müssen, wird S_FALSE zurückgegeben.
KF_REDIRECT_WITH_UI
Wert: 0x20
Anzeige der Benutzeroberfläche während der Umleitung.
KF_REDIRECT_UNPIN
Wert: 0x40
Heben Sie den Quellordner auf.
KF_REDIRECT_PIN
Wert: 0x80
Anheften sie den Zielordner.
KF_REDIRECT_COPY_CONTENTS
Wert: 0x200
Kopieren Sie den vorhandenen Inhalt – dateien und Unterordner – des bekannten Ordners in den umgeleiteten Ordner.
KF_REDIRECT_DEL_SOURCE_CONTENTS
Wert: 0x400
Löschen Sie den Inhalt des Quellordners, nachdem er in den umgeleiteten Ordner kopiert wurde. Dieses Flag ist nur gültig, wenn KF_REDIRECT_COPY_CONTENTS festgelegt ist.
KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS
Wert: 0x800
Reserviert. Darf nicht verwendet werden.

Hinweise

Die KF_REDIRECT_OWNER_USER - und KF_REDIRECT_SET_OWNER_EXPLICIT-Flags bieten Eigentumsprüfung für den Zielordner, sofern dieser Ordner vorhanden ist. Standardmäßig führt IKnownFolderManager::Redirect keine Besitzerüberprüfungen durch. KF_REDIRECT_OWNER_USER und KF_REDIRECT_SET_OWNER_EXPLICIT sind nur gültig, wenn sie zusammen aufgerufen werden.

Der KF_REDIRECT_FLAGS-Typ wird in Shobjidl.h definiert, wie hier gezeigt.

typedef DWORD KF_REDIRECT_FLAGS;

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

Bekannte Ordner (Beispiel)