Partager via

énumération _SHCONTF (shobjidl_core.h)

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

Syntaxe

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

Constants

 
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 des éléments qui sont des dossiers dans l’énumération.
SHCONTF_NONFOLDERS
Valeur : 0x40
0x00040. Incluez les é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’à ce que le 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. Inclure des é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 qui peuvent ê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 à 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 immédiatement retourner un objet non initialisé. Différer l’initialisation jusqu’à la première fois que la méthode IEnumIDList ::Next est appelée. 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 quand hwnd a la valeur 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 pour être un synonyme de DWORD.
 

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Header shobjidl_core.h (include Shobjidl.h)
  • Last updated on