_SHCONTF 枚举 (shobjidl_core.h)

确定枚举中包含的项的类型。 这些值与 IShellFolder::EnumObjects 方法一起使用。

语法

typedef enum _SHCONTF {
  SHCONTF_CHECKING_FOR_CHILDREN = 0x10,
  SHCONTF_FOLDERS = 0x20,
  SHCONTF_NONFOLDERS = 0x40,
  SHCONTF_INCLUDEHIDDEN = 0x80,
  SHCONTF_INIT_ON_FIRST_NEXT = 0x100,
  SHCONTF_NETPRINTERSRCH = 0x200,
  SHCONTF_SHAREABLE = 0x400,
  SHCONTF_STORAGE = 0x800,
  SHCONTF_NAVIGATION_ENUM = 0x1000,
  SHCONTF_FASTITEMS = 0x2000,
  SHCONTF_FLATLIST = 0x4000,
  SHCONTF_ENABLE_ASYNC = 0x8000,
  SHCONTF_INCLUDESUPERHIDDEN = 0x10000
} ;

常量

 
SHCONTF_CHECKING_FOR_CHILDREN
值: 0x10
0x00010。 Windows 7 及更高版本。 调用应用程序正在检查文件夹中是否存在子项。
SHCONTF_FOLDERS
值: 0x20
0x00020。 包括枚举中文件夹的项。
SHCONTF_NONFOLDERS
值: 0x40
0x00040。 包括枚举中不是文件夹的项。
SHCONTF_INCLUDEHIDDEN
值: 0x80
0x00080。 在枚举中包含隐藏项。 这不包括隐藏的系统项。 (若要包含隐藏的系统项,请使用 SHCONTF_INCLUDESUPERHIDDEN.)
SHCONTF_INIT_ON_FIRST_NEXT
值: 0x100
0x00100。 不再使用;始终假定。 IShellFolder::EnumObjects 可以在不验证枚举对象的情况下返回。 验证可以推迟到第一次调用 IEnumIDList::Next。 在第一次 IEnumIDList::Next 调用之前可能显示用户界面时,请使用此标志。 若要显示用户界面,必须将 hwnd 设置为有效的窗口句柄。
SHCONTF_NETPRINTERSRCH
值: 0x200
0x00200。 调用应用程序正在查找打印机对象。
SHCONTF_SHAREABLE
值: 0x400
0x00400。 调用应用程序正在查找可共享的资源。
SHCONTF_STORAGE
值: 0x800
0x00800。 包括具有可访问存储的项及其上级,包括隐藏项。
SHCONTF_NAVIGATION_ENUM
值: 0x1000
0x01000。 Windows 7 及更高版本。 子文件夹应提供导航枚举。
SHCONTF_FASTITEMS
值: 0x2000
0x02000。 Windows Vista 及更高版本。 调用应用程序正在查找可以快速枚举的资源。
SHCONTF_FLATLIST
值: 0x4000
0x04000。 Windows Vista 及更高版本。 已过时。 请勿使用。
SHCONTF_ENABLE_ASYNC
值: 0x8000
0x08000。 Windows Vista 及更高版本。 调用应用程序正在监视更改通知。 这意味着枚举器不必返回所有结果。 可以通过更改通知报告项。
SHCONTF_INCLUDESUPERHIDDEN
值: 0x10000
0x10000。 Windows 7 及更高版本。 在枚举中包含隐藏的系统项。 此值不包括隐藏的非系统项。 (若要包含隐藏的非系统项,请使用 SHCONTF_INCLUDEHIDDEN.)

注解

通过设置 SHCONTF_INIT_ON_FIRST_NEXT 标志,调用应用程序建议 IShellFolder::EnumObjects 方法可以通过返回未初始化的枚举对象来加速枚举过程。 初始化可以推迟到枚举过程开始。 如果初始化枚举对象的过程很长,则方法实现应立即返回未初始化的对象。 将初始化延迟到首次调用 IEnumIDList::Next 方法为止。 如果初始化需要用户输入,则方法实现应使用 hwnd 作为用户界面的父窗口。 有关 hwnd 设置为 NULL 时要执行的操作的说明,请参阅 IShellFolder::EnumObjects 参考。

注意 此枚举的名称已更改为 Windows Vista 中的 _SHCONTF 。 此前,它被命名为 tagSHCONTF。 为了与旧代码兼容,名称 SHCONTF 通过 typedef 语句定义为 DWORD 的同义词。
 

要求

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