énumération _KF_REDIRECT_FLAGS (shobjidl_core.h)

  • Article

Indicateurs utilisés par IKnownFolderManager::Redirect pour spécifier les détails d’une redirection de dossier connue, comme les autorisations et la propriété pour le dossier redirigé.

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
} ;

Constantes

 
KF_REDIRECT_USER_EXCLUSIVE
Valeur : 0x1
Vérifiez que seul l’utilisateur est autorisé à accéder au dossier redirigé.
KF_REDIRECT_COPY_SOURCE_DACL
Valeur : 0x2
Copiez la liste DACL du dossier source dans la cible pour conserver les autorisations d’accès actuelles.
KF_REDIRECT_OWNER_USER
Valeur : 0x4
Définit l’utilisateur en tant que propriétaire d’un dossier cible nouvellement créé, sauf si l’utilisateur est membre du groupe Administrateur, auquel cas Administrateur est défini comme propriétaire. Doit être appelé avec KF_REDIRECT_SET_OWNER_EXPLICIT.
KF_REDIRECT_SET_OWNER_EXPLICIT
Valeur : 0x8
Définissez le propriétaire d’un dossier cible nouvellement créé. Si l’utilisateur appartient au groupe Administrateurs, administrateurs est affecté en tant que propriétaire. Doit être appelé avec KF_REDIRECT_OWNER_USER.
KF_REDIRECT_CHECK_ONLY
Valeur : 0x10
N’effectuez pas de redirection, case activée simplement si la redirection s’est produite. Si c’est le cas, IKnownFolderManager::Redirect retourne S_OK ; si ce n’est pas le cas ou si certaines actions restent à effectuer, elle retourne S_FALSE.
KF_REDIRECT_WITH_UI
Valeur : 0x20
Afficher l’interface utilisateur pendant la redirection.
KF_REDIRECT_UNPIN
Valeur : 0x40
Désépiner le dossier source.
KF_REDIRECT_PIN
Valeur : 0x80
Épingler le dossier cible.
KF_REDIRECT_COPY_CONTENTS
Valeur : 0x200
Copiez le contenu existant (fichiers et sous-dossiers) du dossier connu dans le dossier redirigé.
KF_REDIRECT_DEL_SOURCE_CONTENTS
Valeur : 0x400
Supprimez le contenu du dossier source une fois qu’il a été copié dans le dossier redirigé. Cet indicateur n’est valide que si KF_REDIRECT_COPY_CONTENTS est défini.
KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS
Valeur : 0x800
Réservé. Ne pas utiliser.

Remarques

Les indicateurs KF_REDIRECT_OWNER_USER et KF_REDIRECT_SET_OWNER_EXPLICIT fournissent des vérifications de propriété pour le dossier cible, si ce dossier existe. Par défaut, IKnownFolderManager::Redirect n’effectue pas de vérifications de propriété. KF_REDIRECT_OWNER_USER et KF_REDIRECT_SET_OWNER_EXPLICIT ne sont valides que s’ils sont appelés ensemble.

Le type KF_REDIRECT_FLAGS est défini dans Shobjidl.h, comme illustré ici.

typedef DWORD KF_REDIRECT_FLAGS;

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête shobjidl_core.h (inclure Shobjidl.h)

Voir aussi

Dossiers connus, exemple