Argumento CRUMB (o shell do Windows)
O crumb argumento dá suporte a instruções AQS (Advanced Query Syntax) completas e é especialmente útil como um meio de controlar o escopo de uma pesquisa. Além das instruções AQS, o crumb argumento pode usar um parâmetro especial location no Windows Vista e kind store parâmetros no Windows XP, conforme descrito posteriormente neste tópico.
Este tópico contém as seguintes seções:
Sintaxe de migalhas
A sintaxe de migalhas é a seguinte:
crumb=<column>:<value>[,<label>][,<column>:<value>[,<label>]]&
A <parte da coluna> é qualquer propriedade no sistema de propriedades e a parte do <valor> é um valor válido para essa propriedade. A
Exemplos Gerais
crumb=System.Author:paolo&
crumb=store:mapi&
crumb=location:c%3a%5cMyVacationPix,Vacation&
Usando migalhas com Vista (localização)
No parâmetro crumb, o Windows Vista dá suporte ao AQS completo e também à location propriedade, que tem uma implementação especial disponível apenas no Windows Vista. Você pode usar uma cadeia de caracteres AQS ou a location propriedade dentro de um único parâmetro de migalha, mas não ambos. Se o parâmetro de migalhas incluir AQS, todo o resto nesse parâmetro de migalhas será ignorado.
A location propriedade permite que você especifique um caminho para pesquisar. O Windows Vista pode ignorar o Indexador e percorrer o diretório diretamente se o local estiver fora do escopo de rastreamento do Indexador. Consequentemente, essas pesquisas podem ser mais lentas do que as pesquisas que usam o Indexador.
Quando você especifica uma location propriedade, dois parâmetros adicionais são suportados e opcionais:
| Parâmetro | Valores | Descrição |
|---|---|---|
| inclusão | incluir, excluir | Especifica se a consulta deve incluir ou excluir itens desse caminho. "Incluir" é o padrão. O Windows Vista não oferece suporte a exclusões sem inclusões. (Veja o exemplo) |
| recursão | recursivo, não recursivo | Especifica se a pesquisa deve recursar todas as subpastas a partir do valor definido no location:<value>. "Recursivo" é o padrão. |
Para definir o escopo de uma pesquisa usando o protocolo search: , você tem opções diferentes, dependendo do destino do escopo.
Pasta em uma máquina local:
- Usar AQS (crumb=folder:<Caminho codificado por> URL)
- Usar argumento de localização (crumb=location:<Caminho> codificado por URL)
Pasta em uma máquina/rede remota:
- Usar argumento de localização (crumb=location:<Caminho> codificado por URL)
Pasta acessada por meio de um manipulador de protocolo UNC (Convenção de Nomenclatura Universal) conhecido:
- Use AQS (crumb=store:<Nome do manipulador de protocolo UNC>)
- Usar argumento de localização (crumb=location:<Caminho> codificado por URL)
Exemplos do Vista
search:query=vacation&crumb=location:shell%3aPersonal,include,recursive&
search:crumb=location:c%3a%5cPictures&crumb=location:c%3a%5cPictures%5cDuplicates,,exclude&
search:crumb=location:c%3a%5cDocuments&crumb=kind:pics&
O primeiro exemplo executa uma pesquisa por "férias" começando no shell://Personal local (um atalho especial para a pasta Meus Documentos do usuário), incluindo essa pasta e todas as subpastas. Consulte a tabela abaixo.
O segundo exemplo executa uma pesquisa em C:\Pictures, mas não em C:\Pictures\Duplicates.
O terceiro exemplo executa uma pesquisa em C:\Documents, limitada a arquivos com a kind propriedade definida como pics.
Constantes para pastas comuns
O Windows Vista permite o uso de valores CSIDL que fornecem uma maneira exclusiva independente do sistema de identificar pastas especiais usadas com freqüência por aplicativos, mas que podem não ter o mesmo nome ou local em um determinado sistema. Por exemplo, a pasta do sistema pode ser "C:\Windows" em um sistema e "C:\Winnt" em outro.
Use estes locais com esta sintaxe:
crumb=location:shell%3a<LocationName>&
A tabela a seguir lista os valores CSIDL. Consulte ShellSpecialFolderConstants para obter mais informações.
| Nome | localizar sequência | Descrição |
|---|---|---|
| FERRAMENTAS ADMINISTRATIVAS | ADMINISTRATIVO%20FERRAMENTAS | Diretório do sistema de arquivos que serve como um repositório para ferramentas administrativas. |
| APPDATA | APPDATA | Diretório do sistema de arquivos que serve como um repositório comum para dados específicos do aplicativo. Um caminho típico é C:\Documents and Settings\username\Application Data. |
| CACHE | CACHE | Diretório do sistema de arquivos que serve como um repositório comum para arquivos temporários da Internet. Um caminho típico é C:\Documents and Settings\username\Temporary Internet Files. |
| GRAVAÇÃO DE CD | CD%20GRAVAÇÃO | Pasta contendo dados a serem gravados em CD. |
| FERRAMENTAS ADMINISTRATIVAS COMUNS | COMUM%20ADMINISTRATIVO%20FERRAMENTAS | Ferramentas administrativas para todos os usuários. |
| APPDATA COMUM | COMMON%20APPDATA | Dados do aplicativo para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Application Data. |
| ÁREA DE TRABALHO COMUM | ÁREA DE TRABALHO COMUM | Dados do Microsoft Windows Desktop para todos os usuários. Pasta virtual que é a raiz do namespace. |
| DOCUMENTOS COMUNS | COMUM%20DOCUMENTOS | Documentos para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\My Documents. |
| PROGRAMAS COMUNS | COMMON%20PROGRAMAS | Grupos de programas comuns a todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu\Programs. |
| MENU INICIAR COMUM | COMUM%20INICIAR%20MENU | Itens do menu Iniciar comuns a todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu. |
| INICIALIZAÇÃO COMUM | COMUM%20INICIALIZAÇÃO | Grupo de programas de inicialização comum a todos os usuários. |
| MODELOS COMUNS | COMUM%20MODELOS | Modelos de documentos comuns a todos os usuários. |
| MÚSICA COMUM | MINHA%20MÚSICA | Modelos de pasta Minhas Músicas comuns a todos os usuários. |
| IMAGENS COMUNS | MEUS%20FOTOS | Modelos de pasta Minhas Imagens comuns a todos os usuários. |
| VÍDEO COMUM | MEU%20VÍDEO | Modelos de pasta Meu vídeo comuns a todos os usuários. |
| CONEXÕESPASTA | CONEXÕESPASTA | pasta contendo dados de conexão. |
| PASTA DO PAINEL DE CONTROLE | CONTROLPANELFOLDER | Pasta virtual contendo ícones para os aplicativos do Painel de Controle. |
| COOKIES | COOKIES | Diretório do sistema de arquivos que serve como um repositório comum para cookies da Internet. Um caminho típico é C:\Documents and Settings\username\Cookies. |
| DESKTOP | DESKTOP | Área de trabalho do Microsoft Windows. Pasta virtual que é a raiz do namespace. |
| FAVORITOS | FAVORITOS | Diretório do sistema de arquivos que serve como um repositório comum para os itens favoritos do usuário. Um caminho típico é C:\Documents and Settings\username\Favorites. |
| FONTES | FONTES | Pasta virtual contendo fontes instaladas. Um caminho típico é C:\WINDOWS\Fonts. |
| HISTÓRICO | HISTÓRICO | Diretório do sistema de arquivos que serve como um repositório comum para itens de histórico da Internet. |
| INTERNETFOLDER | INTERNETFOLDER | Pasta que contém dados da Internet. |
| DADOS DE APLICATIVOS LOCAIS | LOCAL%20APPDATA | Diretório do sistema de arquivos que serve como um repositório de dados para aplicativos locais (não móveis). Um caminho típico é C:\Documents and Settings\username\Local Settings\Application Data. |
| LOCALIZEDRESOURCEDIR | LOCALIZEDRESOURCEDIR | Diretório de recursos localizado. |
| MINHAPASTACOMPUTADOR | MINHAPASTACOMPUTADOR | Meu Computador. Pasta virtual que contém tudo no computador local: dispositivos de armazenamento, impressoras e Painel de Controle. Essa pasta também pode conter unidades de rede mapeadas. |
| MINHA MÚSICA | MINHA%20MÚSICA | Pasta Minhas músicas. Um caminho típico é C:\Documents and Settings\username\My Documents\My Music. |
| MINHAS FOTOS | MEUS%20FOTOS | Pasta Minhas Imagens. Um caminho típico é C:\Documents and Settings\username\My Documents\My Pictures. |
| MEU VÍDEO | MEU%20VÍDEO | Minha pasta de vídeo. Um caminho típico é C:\Documents and Settings\username\My Documents\My Video. |
| CAPUZ DE REDE | CAPUZ DE REDE | Pasta virtual que representa a raiz da hierarquia de namespace de rede. |
| PASTA LOCAIS DE REDE | NETWORKDLUGARESPASTA | Uma pasta do sistema de arquivos que contém os objetos de link que podem existir na pasta virtual Meus Locais de Rede. Não é o mesmo que NETHOOD, que representa a raiz do namespace de rede. |
| OEM LINKS | OEM%20LINKS | Pasta que contém links para sites OEM. |
| PESSOAL | PESSOAL | Diretório do sistema de arquivos que serve como um repositório comum para os documentos de um usuário. Um caminho típico é C:\Documents and Settings\username\My Documents. |
| PASTA DE IMPRESSORAS | PASTA DE IMPRESSORAS | Pasta virtual contendo impressoras instaladas. |
| CAPUZ | CAPUZ | Diretório do sistema de arquivos que contém os objetos de link que podem existir na pasta virtual Impressoras. Um caminho típico é C:\Documents and Settings\username\PrintHood. |
| PROGRAMAS | PROGRAMAS | Diretório do sistema de arquivos que contém os grupos de programas do usuário (que também são diretórios do sistema de arquivos). Um caminho típico é C:\Documents and Settings\username\Start Menu\Programs. |
| PROFILE | PROFILE | Pasta de perfil do usuário. |
| ARQUIVOS DE PROGRAMAS | PROGRAMA%20ARQUIVOS | Pasta Arquivos de Programas. Um caminho típico é C:\Arquivos de Programas. |
| ARQUIVOS DE PROGRAMAS COMUNS | ARQUIVOS DE PROGRAMASCOMUM | Pasta Arquivos de Programas comum a todos os usuários. |
| ARQUIVOS DE PROGRAMAS COMUNS x86 | PROGRAMFILESCOMMONX86 | Pasta Arquivos de Programas comum a todos os usuários em máquinas x86. |
| ARQUIVOS DE PROGRAMASx86 | PROGRAMFILESx86 | Pasta Arquivos de Programas em máquinas x86. |
| RECENTE | RECENTE | Diretório do sistema de arquivos que contém os documentos usados mais recentemente pelo usuário. Um caminho típico é C:\Documents and Settings\username\Recent. |
| PASTA DA LIXEIRA | PASTA DE RECICLAGEM | Pasta virtual que contém os objetos na Lixeira do usuário. |
| RESOURCEDIR | RESOURCEDIR | O diretório de recursos. |
| ENVIAR | ENVIAR | Diretório do sistema de arquivos que contém itens de menu Enviar para. Um caminho típico é C:\Documents and Settings\username\SendTo. |
| MENU INICIAR | INICIAR%20MENU | Diretório do sistema de arquivos contendo itens do menu Iniciar. Um caminho típico é C:\Documents and Settings\username\Start Menu. |
| INICIALIZAÇÃO | INICIALIZAÇÃO | Diretório do sistema de arquivos que corresponde ao grupo de programas de inicialização do usuário. |
| SISTEMAx86 | SISTEMAx86 | Pasta do sistema em máquinas x86. |
| MODELOS | MODELOS | Diretório do sistema de arquivos que serve como um repositório comum para modelos de documentos. |
| SISTEMA | SISTEMA | Pasta do sistema. Um caminho típico é C:\Windows\System. |
| WINDOWS | WINDOWS | Windows ou SYSROOT. |
Informações do argumento
| Valor | |
|---|---|
| Sistema operacional mínimo | Windows Vista com Service Pack 1 (SP1) |