Compartir a través de

enumeración _SHCONTF (shobjidl_core.h)

  • Artículo

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

Constantes

 
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. Incluir elementos que no son 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 supone. 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 debe usarse.
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 notificaciones de cambios.
SHCONTF_INCLUDESUPERHIDDEN
Valor: 0x10000
0x10000. Windows 7 y versiones posteriores. Incluya 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).

Comentarios

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 no inicializado. La inicialización se puede aplazar hasta que se inicia 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, consulte la referencia de IShellFolder::EnumObjects .

Nota El nombre de esta enumeración se cambió a _SHCONTF en Windows Vista. Anteriormente, se denominaba 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 sinónimo de DWORD.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado shobjidl_core.h (include Shobjidl.h)