énumération _SHCONTF (shobjidl_core.h)

  • Article

Détermine les types d’éléments inclus dans une énumération. Ces valeurs sont utilisées avec la méthode IShellFolder ::EnumObjects .

Syntax

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

Constantes

 
SHCONTF_CHECKING_FOR_CHILDREN
Valeur : 0x10
0x00010. Windows 7 et versions ultérieures. L’application appelante vérifie l’existence d’éléments enfants dans le dossier.
SHCONTF_FOLDERS
Valeur : 0x20
0x00020. Incluez les éléments qui sont des dossiers dans l’énumération.
SHCONTF_NONFOLDERS
Valeur : 0x40
0x00040. Incluez des éléments qui ne sont pas des dossiers dans l’énumération.
SHCONTF_INCLUDEHIDDEN
Valeur : 0x80
0x00080. Incluez les éléments masqués dans l’énumération. Cela n’inclut pas les éléments système masqués. (Pour inclure des éléments système masqués, utilisez SHCONTF_INCLUDESUPERHIDDEN.)
SHCONTF_INIT_ON_FIRST_NEXT
Valeur : 0x100
0x00100. N’est plus utilisé ; toujours supposé. IShellFolder ::EnumObjects peut retourner sans valider l’objet d’énumération. La validation peut être reportée jusqu’au premier appel à IEnumIDList ::Next. Utilisez cet indicateur lorsqu’une interface utilisateur peut être affichée avant le premier appel IEnumIDList ::Next . Pour qu’une interface utilisateur soit présentée, hwnd doit être défini sur un handle de fenêtre valide.
SHCONTF_NETPRINTERSRCH
Valeur : 0x200
0x00200. L’application appelante recherche des objets d’imprimante.
SHCONTF_SHAREABLE
Valeur : 0x400
0x00400. L’application appelante recherche des ressources qui peuvent être partagées.
SHCONTF_STORAGE
Valeur : 0x800
0x00800. Incluez les éléments avec un stockage accessible et leurs ancêtres, y compris les éléments masqués.
SHCONTF_NAVIGATION_ENUM
Valeur : 0x1000
0x01000. Windows 7 et versions ultérieures. Les dossiers enfants doivent fournir une énumération de navigation.
SHCONTF_FASTITEMS
Valeur : 0x2000
0x02000. Windows Vista et versions ultérieures. L’application appelante recherche des ressources pouvant être énumérées rapidement.
SHCONTF_FLATLIST
Valeur : 0x4000
0x04000. Windows Vista et versions ultérieures. Obsolète. Ne pas utiliser.
SHCONTF_ENABLE_ASYNC
Valeur : 0x8000
0x08000. Windows Vista et versions ultérieures. L’application appelante surveille les notifications de modification. Cela signifie que l’énumérateur n’a pas besoin de retourner tous les résultats. Les éléments peuvent être signalés par le biais de notifications de modification.
SHCONTF_INCLUDESUPERHIDDEN
Valeur : 0x10000
0x10000. Windows 7 et versions ultérieures. Incluez les éléments système masqués dans l’énumération. Cette valeur n’inclut pas les éléments non-système masqués. (Pour inclure des éléments non système masqués, utilisez SHCONTF_INCLUDEHIDDEN.)

Remarques

En définissant l’indicateur SHCONTF_INIT_ON_FIRST_NEXT , l’application appelante suggère que la méthode IShellFolder ::EnumObjects peut accélérer le processus d’énumération en retournant un objet d’énumération non initialisé. L’initialisation peut être différée jusqu’au démarrage du processus d’énumération. Si l’initialisation de l’objet d’énumération est un processus long, l’implémentation de la méthode doit retourner immédiatement un objet non initialisé. Différer l’initialisation jusqu’à ce que la méthode IEnumIDList ::Next soit appelée pour la première fois. Si l’initialisation nécessite une entrée utilisateur, l’implémentation de la méthode doit utiliser hwnd comme fenêtre parente pour l’interface utilisateur. Pour obtenir une explication de ce qu’il faut faire lorsque hwnd est défini sur NULL, consultez la référence IShellFolder ::EnumObjects .

Note Le nom de cette énumération a été modifié en _SHCONTF dans Windows Vista. Auparavant, il s’appelait tagSHCONTF. Pour la compatibilité avec le code hérité, le nom SHCONTF est défini par le biais d’une instruction typedef comme synonyme de DWORD.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête shobjidl_core.h (incluez Shobjidl.h)