Partilhar via


Argumento CRUMB (O Shell do Windows)

O argumento crumb suporta 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 argumento crumb pode ter um parâmetro location especial no Windows Vista e parâmetros kind e store no Windows XP, conforme descrito posteriormente neste tópico.

Este tópico contém as seguintes seções:

Sintaxe Crumb

A sintaxe crumb é a seguinte:

crumb=<column>:<value>[,<label>][,<column>:<value>[,<label>]]& 

A coluna <> parte é qualquer propriedade no sistema de propriedades, e o valor <> parte é um valor válido para essa propriedade. A parte

Exemplos gerais

crumb=System.Author:paolo&
crumb=store:mapi&
crumb=location:c%3a%5cMyVacationPix,Vacation&

Usando migalhas com o Vista (localização)

No parâmetro crumb, o Windows Vista suporta AQS completo e também a propriedade location, que tem uma implementação especial disponível apenas no Windows Vista. Você pode usar uma cadeia de caracteres AQS ou a propriedade location dentro de um único parâmetro crumb, mas não ambos. Se o parâmetro crumb incluir AQS, todo o resto nesse parâmetro crumb será ignorado.

A propriedade location permite especificar um caminho para pesquisar. O Windows Vista pode ignorar o Indexador e atravessar 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 propriedade location, 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. (Ver exemplo)
Recursão recursivo, não recursivo Especifica se a pesquisa deve recursar todas as subpastas a partir do valor definido no local:<valor>. "Recursivo" é o padrão.

 

Para definir o escopo de uma pesquisa usando a pesquisa : protocolo, você tem diferentes opções dependendo do destino do escopo.

Pasta em uma máquina local:

  • Use AQS (crumb=folder:<caminho codificado por URL>)
  • Use o argumento location (crumb=location:<caminho codificado por URL>)

Pasta em uma máquina/rede remota:

  • Use o argumento location (crumb=location:<caminho codificado por URL>)

Pasta acessada por meio de um manipulador de protocolo UNC (Convenção Universal de Nomenclatura) conhecido:

  • Use AQS (crumb=store:<nome do manipulador de protocolo UNC>)
  • Use o argumento location (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 local shell://Personal (um atalho especial para a pasta Meus Documentos do usuário), incluindo essa pasta e todas as subpastas. Veja 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 propriedade kind definida como pics.

Constantes para pastas comuns

O Windows Vista permite o uso de valores CSIDL que fornecem uma maneira exclusiva independente do sistema para identificar pastas especiais usadas com freqüência por aplicativos, mas que podem não ter o mesmo nome ou local em qualquer 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.

Designação cadeia de pesquisa Descrição
FERRAMENTAS ADMINISTRATIVAS %20TOOLS ADMINISTRATIVO 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%20BURNING Pasta contendo dados a serem gravados em CD.
INSTRUMENTOS ADMINISTRATIVOS COMUNS COMUM%20ADMINISTRATIVE%20TOOLS Ferramentas administrativas para todos os utilizadores.
APPDATA COMUM COMUM%20APPDATA Dados de aplicação para todos os utilizadores. Um caminho típico é C:\Documents and Settings\All Users\Application Data.
AMBIENTE DE TRABALHO COMUM AMBIENTE DE TRABALHO COMUM Dados da área de trabalho do Microsoft Windows para todos os usuários. Pasta virtual que é a raiz do namespace.
DOCUMENTOS COMUNS COMUM%20DOCUMENTS Documentos para todos os utilizadores. Um caminho típico é C:\Documents and Settings\All Users\My Documents.
PROGRAMAS COMUNS COMUM%20PROGRAMS Grupos de programas comuns a todos os utilizadores. Um caminho típico é C:\Documents and Settings\All Users\Start Menu\Programs.
MENU INICIAR COMUM COMUM%20START%20MENU Itens do menu Iniciar comuns a todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu.
ARRANQUE COMUM COMUM%20STARTUP Grupo de programas de inicialização comum a todos os usuários.
MODELOS COMUNS COMUM%20TEMPLATES Modelos de documentos comuns a todos os utilizadores.
MÚSICA COMUM MEU%20MUSIC Modelos de pasta Minhas Músicas comuns a todos os usuários.
IMAGENS COMUNS MEU%20PICTURES Modelos de pasta Minhas Imagens comuns a todos os usuários.
COMMONVIDEO MEU%20VIDEO Meus modelos de pasta de vídeo comuns a todos os usuários.
CONEXÕESPASTA CONEXÕESPASTA pasta que contém dados de conexão.
PASTA DO PAINEL DE CONTROLO CONTROLPANELPASTA 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.
VERSÃO DESKTOP VERSÃO 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ÓRIA HISTÓRIA Diretório do sistema de arquivos que serve como um repositório comum para itens do histórico da Internet.
INTERNETPASTA INTERNETPASTA Pasta que contém dados da Internet.
LOCAL APPDATA %20APPDATA LOCAIS 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.
MYCOMPUTERPASTA MYCOMPUTERPASTA O meu computador. Pasta virtual contendo tudo no computador local: dispositivos de armazenamento, impressoras e Painel de Controle. Esta pasta também pode conter unidades de rede mapeadas.
A MINHA MÚSICA MEU%20MUSIC Pasta A Minha Música. Um caminho típico é C:\Documents and Settings\username\My Documents\My Music.
MINHAS FOTOS MEU%20PICTURES Pasta Minhas Imagens. Um caminho típico é C:\Documents and Settings\username\My Documents\My Pictures.
O MEU VÍDEO MEU%20VIDEO Minha pasta de vídeo. Um caminho típico é C:\Documents and Settings\username\My Documents\My Video.
NETHOOD NETHOOD Pasta virtual que representa a raiz da hierarquia de namespace de rede.
PASTA LOCAIS DE REDE NETWORKDPLACESPASTA 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 %20LINKS OEM 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 IMPRESSO CAPUZ IMPRESSO 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.
PERFIL PERFIL Pasta de perfil do usuário.
ARQUIVOS DE PROGRAMAS PROGRAMA%20FILES Pasta Arquivos de Programas. Um caminho típico é C:\Program Files.
ARQUIVOS DE PROGRAMAS COMUNS PROGRAMFILESCOMMON 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 ARQUIVOS DE PROGRAMASx86 Pasta Arquivos de Programas em máquinas x86.
RECENTES RECENTES 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 RECYCLEBINPASTA Pasta virtual que contém os objetos na Lixeira do usuário.
RESOURCEDIR RESOURCEDIR O diretório de recursos.
SENDTO SENDTO 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 INÍCIO%20MENU Diretório do sistema de arquivos contendo itens do menu Iniciar. Um caminho típico é C:\Documents and Settings\username\Start Menu.
ARRANQUE ARRANQUE 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.
MAC OS MAC OS Diretório do Windows ou SYSROOT.

 

Informações sobre argumentos

Valor
mínimo do sistema operacional Windows Vista com Service Pack 1 (SP1)