_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_USER和KF_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) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈