SHCONTF enumeration

Determines the types of items included in an enumeration. These values are used with the IShellFolder::EnumObjects method.

Syntax

typedef enum _SHCONTF { 
  SHCONTF_CHECKING_FOR_CHILDREN  = 0x00010,
  SHCONTF_FOLDERS                = 0x00020,
  SHCONTF_NONFOLDERS             = 0x00040,
  SHCONTF_INCLUDEHIDDEN          = 0x00080,
  SHCONTF_INIT_ON_FIRST_NEXT     = 0x00100,
  SHCONTF_NETPRINTERSRCH         = 0x00200,
  SHCONTF_SHAREABLE              = 0x00400,
  SHCONTF_STORAGE                = 0x00800,
  SHCONTF_NAVIGATION_ENUM        = 0x01000,
  SHCONTF_FASTITEMS              = 0x02000,
  SHCONTF_FLATLIST               = 0x04000,
  SHCONTF_ENABLE_ASYNC           = 0x08000,
  SHCONTF_INCLUDESUPERHIDDEN     = 0x10000
} SHCONTF;

Constants

SHCONTF_CHECKING_FOR_CHILDREN

0x00010. Windows 7 and later. The calling application is checking for the existence of child items in the folder.

SHCONTF_FOLDERS

0x00020. Include items that are folders in the enumeration.

SHCONTF_NONFOLDERS

0x00040. Include items that are not folders in the enumeration.

SHCONTF_INCLUDEHIDDEN

0x00080. Include hidden items in the enumeration. This does not include hidden system items. (To include hidden system items, use SHCONTF_INCLUDESUPERHIDDEN.)

SHCONTF_INIT_ON_FIRST_NEXT

0x00100. No longer used; always assumed. IShellFolder::EnumObjects can return without validating the enumeration object. Validation can be postponed until the first call to IEnumIDList::Next. Use this flag when a user interface might be displayed prior to the first IEnumIDList::Next call. For a user interface to be presented, hwnd must be set to a valid window handle.

SHCONTF_NETPRINTERSRCH

0x00200. The calling application is looking for printer objects.

SHCONTF_SHAREABLE

0x00400. The calling application is looking for resources that can be shared.

SHCONTF_STORAGE

0x00800. Include items with accessible storage and their ancestors, including hidden items.

SHCONTF_NAVIGATION_ENUM

0x01000. Windows 7 and later. Child folders should provide a navigation enumeration.

SHCONTF_FASTITEMS

0x02000. Windows Vista and later. The calling application is looking for resources that can be enumerated quickly.

SHCONTF_FLATLIST

0x04000. Windows Vista and later. Enumerate items as a simple list even if the folder itself is not structured in that way.

SHCONTF_ENABLE_ASYNC

0x08000. Windows Vista and later. The calling application is monitoring for change notifications. This means that the enumerator does not have to return all results. Items can be reported through change notifications.

SHCONTF_INCLUDESUPERHIDDEN

0x10000. Windows 7 and later. Include hidden system items in the enumeration. This value does not include hidden non-system items. (To include hidden non-system items, use SHCONTF_INCLUDEHIDDEN.)

Remarks

By setting the SHCONTF_INIT_ON_FIRST_NEXT flag, the calling application suggests that the IShellFolder::EnumObjects method can expedite the enumeration process by returning an uninitialized enumeration object. Initialization can be deferred until the enumeration process starts. If initializing the enumeration object is a lengthy process, the method implementation should immediately return an uninitialized object. Defer initialization until the first time the IEnumIDList::Next method is called. If initialization requires user input, the method implementation should use hwnd as the parent window for the user interface. For an explanation of what to do when hwnd is set to NULL, see the IShellFolder::EnumObjects reference.

Requirements