_KF_REDIRECT_FLAGS 枚举 (shobjidl_core.h)

IKnownFolderManager::Redirect 使用的标志,用于指定已知文件夹重定向的详细信息,例如重定向文件夹的权限和所有权。

语法

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

常量

 
KF_REDIRECT_USER_EXCLUSIVE
值: 0x1
确保只有用户有权访问重定向的文件夹。
KF_REDIRECT_COPY_SOURCE_DACL
值: 0x2
将源文件夹的 DACL 复制到目标以保持当前访问权限。
KF_REDIRECT_OWNER_USER
值: 0x4
将用户设置为新创建的目标文件夹的所有者,除非该用户是管理员组的成员,在这种情况下,管理员设置为所有者。 必须使用 KF_REDIRECT_SET_OWNER_EXPLICIT 调用。
KF_REDIRECT_SET_OWNER_EXPLICIT
值: 0x8
设置新创建的目标文件夹的所有者。 如果用户属于管理员组,则会将管理员分配为所有者。 必须使用 KF_REDIRECT_OWNER_USER 调用。
KF_REDIRECT_CHECK_ONLY
值: 0x10
不要执行重定向,只需检查是否已发生重定向。 如果是这样, IKnownFolderManager::Redirect 返回S_OK;如果不是,或者某些操作仍有待完成,则返回S_FALSE。
KF_REDIRECT_WITH_UI
值: 0x20
在重定向期间显示 UI。
KF_REDIRECT_UNPIN
值: 0x40
取消固定源文件夹。
KF_REDIRECT_PIN
值: 0x80
固定目标文件夹。
KF_REDIRECT_COPY_CONTENTS
值: 0x200
将已知文件夹的现有内容(文件和子文件夹)复制到重定向的文件夹。
KF_REDIRECT_DEL_SOURCE_CONTENTS
值: 0x400
将源文件夹的内容复制到重定向文件夹后,请将其删除。 仅当设置了 KF_REDIRECT_COPY_CONTENTS 时,此标志才有效。
KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS
值: 0x800
保留。 请勿使用。

注解

KF_REDIRECT_OWNER_USERKF_REDIRECT_SET_OWNER_EXPLICIT标志提供目标文件夹(如果该文件夹存在)的所有权检查。 默认情况下, IKnownFolderManager::Redirect 不执行所有权检查。 KF_REDIRECT_OWNER_USER和KF_REDIRECT_SET_OWNER_EXPLICIT仅在一起调用时才有效。

KF_REDIRECT_FLAGS类型在 Shobjidl.h 中定义,如下所示。

typedef DWORD KF_REDIRECT_FLAGS;

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

已知文件夹示例