Compartir a través de


enumeración _SHCONTF (shobjidl_core.h)

Determina los tipos de elementos incluidos en una enumeración. Estos valores se usan con el método 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
} ;

Constants

 
SHCONTF_CHECKING_FOR_CHILDREN
Valor: 0x10
0x00010. Windows 7 y versiones posteriores. La aplicación que realiza la llamada comprueba la existencia de elementos secundarios en la carpeta .
SHCONTF_FOLDERS
Valor: 0x20
0x00020. Incluir elementos que son carpetas en la enumeración.
SHCONTF_NONFOLDERS
Valor: 0x40
0x00040. Incluya elementos que no sean carpetas en la enumeración.
SHCONTF_INCLUDEHIDDEN
Valor: 0x80
0x00080. Incluir elementos ocultos en la enumeración. Esto no incluye elementos ocultos del sistema. (Para incluir elementos ocultos del sistema, use SHCONTF_INCLUDESUPERHIDDEN).
SHCONTF_INIT_ON_FIRST_NEXT
Valor: 0x100
0x00100. Ya no se usa; siempre se presupone. IShellFolder::EnumObjects puede devolver sin validar el objeto de enumeración. La validación se puede posponer hasta la primera llamada a IEnumIDList::Next. Use esta marca cuando se muestre una interfaz de usuario antes de la primera llamada IEnumIDList::Next . Para que se presente una interfaz de usuario, hwnd debe establecerse en un identificador de ventana válido.
SHCONTF_NETPRINTERSRCH
Valor: 0x200
0x00200. La aplicación que realiza la llamada busca objetos de impresora.
SHCONTF_SHAREABLE
Valor: 0x400
0x00400. La aplicación que realiza la llamada busca recursos que se pueden compartir.
SHCONTF_STORAGE
Valor: 0x800
0x00800. Incluya elementos con almacenamiento accesible y sus antecesores, incluidos los elementos ocultos.
SHCONTF_NAVIGATION_ENUM
Valor: 0x1000
0x01000. Windows 7 y versiones posteriores. Las carpetas secundarias deben proporcionar una enumeración de navegación.
SHCONTF_FASTITEMS
Valor: 0x2000
0x02000. Windows Vista y versiones posteriores. La aplicación que realiza la llamada busca recursos que se pueden enumerar rápidamente.
SHCONTF_FLATLIST
Valor: 0x4000
0x04000. Windows Vista y versiones posteriores. Obsoleto. No usar.
SHCONTF_ENABLE_ASYNC
Valor: 0x8000
0x08000. Windows Vista y versiones posteriores. La aplicación que realiza la llamada está supervisando las notificaciones de cambios. Esto significa que el enumerador no tiene que devolver todos los resultados. Los elementos se pueden notificar a través de las notificaciones de cambio.
SHCONTF_INCLUDESUPERHIDDEN
Valor: 0x10000
0x10000. Windows 7 y versiones posteriores. Incluir elementos ocultos del sistema en la enumeración. Este valor no incluye elementos ocultos que no son del sistema. (Para incluir elementos ocultos que no son del sistema, use SHCONTF_INCLUDEHIDDEN).

Observaciones

Al establecer la marca SHCONTF_INIT_ON_FIRST_NEXT , la aplicación que realiza la llamada sugiere que el método IShellFolder::EnumObjects puede acelerar el proceso de enumeración devolviendo un objeto de enumeración sin inicializar. La inicialización se puede aplazar hasta que se inicie el proceso de enumeración. Si inicializar el objeto de enumeración es un proceso largo, la implementación del método debe devolver inmediatamente un objeto sin inicializar. Aplazar la inicialización hasta la primera vez que se llama al método IEnumIDList::Next . Si la inicialización requiere la entrada del usuario, la implementación del método debe usar hwnd como ventana primaria para la interfaz de usuario. Para obtener una explicación de qué hacer cuando hwnd está establecido en NULL, vea la referencia de IShellFolder::EnumObjects .

Nota El nombre de esta enumeración se cambió a _SHCONTF en Windows Vista. Anteriormente, se llamaba tagSHCONTF. Para la compatibilidad con el código heredado, el nombre SHCONTF se define a través de una instrucción typedef para que sea un sinónimo de DWORD.
 

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
Header shobjidl_core.h (incluya Shobjidl.h)