enumeração _SHCONTF (shobjidl_core.h)

  • Artigo

Determina os tipos de itens incluídos em uma enumeração. Esses valores são usados com o 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 e posterior. O aplicativo de chamada está verificando a existência de itens filho na pasta.
SHCONTF_FOLDERS
Valor: 0x20
0x00020. Inclua itens que são pastas na enumeração .
SHCONTF_NONFOLDERS
Valor: 0x40
0x00040. Inclua itens que não são pastas na enumeração.
SHCONTF_INCLUDEHIDDEN
Valor: 0x80
0x00080. Inclua itens ocultos na enumeração . Isso não inclui itens ocultos do sistema. (Para incluir itens ocultos do sistema, use SHCONTF_INCLUDESUPERHIDDEN.)
SHCONTF_INIT_ON_FIRST_NEXT
Valor: 0x100
0x00100. Não mais usado; sempre presumido. IShellFolder::EnumObjects pode retornar sem validar o objeto de enumeração. A validação pode ser adiada até a primeira chamada para IEnumIDList::Next. Use esse sinalizador quando uma interface do usuário puder ser exibida antes da primeira chamada IEnumIDList::Next . Para que uma interface do usuário seja apresentada, o hwnd deve ser definido como um identificador de janela válido.
SHCONTF_NETPRINTERSRCH
Valor: 0x200
0x00200. O aplicativo de chamada está procurando objetos de impressora.
SHCONTF_SHAREABLE
Valor: 0x400
0x00400. O aplicativo de chamada está procurando recursos que podem ser compartilhados.
SHCONTF_STORAGE
Valor: 0x800
0x00800. Inclua itens com armazenamento acessível e seus ancestrais, incluindo itens ocultos.
SHCONTF_NAVIGATION_ENUM
Valor: 0x1000
0x01000. Windows 7 e posterior. As pastas filho devem fornecer uma enumeração de navegação.
SHCONTF_FASTITEMS
Valor: 0x2000
0x02000. Windows Vista e posteriores. O aplicativo de chamada está procurando recursos que podem ser enumerados rapidamente.
SHCONTF_FLATLIST
Valor: 0x4000
0x04000. Windows Vista e posteriores. Obsoleto. Não use.
SHCONTF_ENABLE_ASYNC
Valor: 0x8000
0x08000. Windows Vista e posteriores. O aplicativo de chamada está monitorando as notificações de alteração. Isso significa que o enumerador não precisa retornar todos os resultados. Os itens podem ser relatados por meio de notificações de alteração.
SHCONTF_INCLUDESUPERHIDDEN
Valor: 0x10000
0x10000. Windows 7 e posterior. Inclua itens ocultos do sistema na enumeração . Esse valor não inclui itens ocultos que não são do sistema. (Para incluir itens não-sistema ocultos, use SHCONTF_INCLUDEHIDDEN.)

Comentários

Ao definir o sinalizador SHCONTF_INIT_ON_FIRST_NEXT , o aplicativo de chamada sugere que o método IShellFolder::EnumObjects pode agilizar o processo de enumeração retornando um objeto de enumeração não inicializado. A inicialização pode ser adiada até que o processo de enumeração seja iniciado. Se inicializar o objeto de enumeração for um processo longo, a implementação do método deverá retornar imediatamente um objeto não inicializado. Adie a inicialização até a primeira vez que o método IEnumIDList::Next for chamado. Se a inicialização exigir entrada do usuário, a implementação do método deverá usar hwnd como a janela pai para a interface do usuário. Para obter uma explicação do que fazer quando hwnd estiver definido como NULL, consulte a referência IShellFolder::EnumObjects .

Nota O nome dessa enumeração foi alterado para _SHCONTF no Windows Vista. Anteriormente, ele era nomeado tagSHCONTF. Para compatibilidade com o código herdado, o nome SHCONTF é definido por meio de uma instrução typedef para ser um sinônimo de DWORD.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)