Ler em inglês

Compartilhar via


Funções de manipulação de caminho de shell

Esta seção descreve as funções de manipulação de caminho do Windows Shell. Os elementos de programação explicados nesta documentação são exportados pelo Shlwapi.dll e definidos em Shlwapi.h e Shlwapi.lib.

Nesta seção

Tópico Descrição
PathAddBackslash
Adiciona uma barra invertida ao final de uma cadeia de caracteres para criar a sintaxe correta para um caminho. Se o caminho de origem já tiver uma barra invertida à direita, nenhuma barra invertida será adicionada.
Observação: o uso indevido dessa função pode levar a uma saturação do buffer. Recomendamos o uso da função PathCchAddBackslash ou PathCchAddBackslashEx mais segura em seu lugar.
Extensão PathAddExtension
Adiciona uma extensão de nome de arquivo a uma cadeia de caracteres de caminho.
Observação: o uso indevido dessa função pode levar a uma saturação do buffer. Recomendamos o uso da função PathCchAddExtension mais segura em seu lugar.
PathAppend
Acrescenta um caminho ao final de outro.
Observação: o uso indevido dessa função pode levar a uma saturação do buffer. Recomendamos o uso da função PathCchAppend ou PathCchAppendEx mais segura em seu lugar.
Raiz de construção de caminho
Cria um caminho raiz a partir de um determinado número de unidade.
PathCanonicalize
Simplifica um caminho removendo elementos de navegação como "." e ".." para produzir um caminho direto e bem formado.
Combinação de caminhos
Concatena duas cadeias de caracteres que representam caminhos formados corretamente em um caminho; também concatena quaisquer elementos de caminho relativos.
Observação: o uso indevido dessa função pode levar a uma saturação do buffer. Recomendamos o uso da função PathCchCombine ou PathCchCombineEx mais segura em seu lugar.
Prefixo Comum do Caminho
Compara dois caminhos para determinar se eles compartilham um prefixo comum. Um prefixo é um destes tipos: "C:\", ".", "..", ".. \".
Caminho Compacto
Trunca um caminho de arquivo para caber em uma determinada largura de pixel, substituindo os componentes do caminho por reticências.
CaminhoCompactoCaminhoEx
Trunca um caminho para caber em um determinado número de caracteres, substituindo os componentes do caminho por reticências.
PathCreateFromUrl
Converte uma URL de arquivo em um caminho do Microsoft MS-DOS.
PathCreateFromUrlAlloc
Cria um caminho a partir de uma URL de arquivo.
PathFileExists
Determina se um caminho para um objeto do sistema de arquivos, como um arquivo ou pasta, é válido.
Extensão PathFindExtension
Pesquisa um caminho para uma extensão.
CaminhoEncontrarFileName
Pesquisa um caminho para um nome de arquivo.
CaminhoEncontrarPróximoComponente
Analisa um caminho e retorna a parte desse caminho que segue a primeira barra invertida.
CaminhoEncontrarOnCaminho
Pesquisa um arquivo.
CaminhoEncontrarSuffixArray
Determina se um determinado nome de arquivo tem um de uma lista de sufixos.
PathGetArgs
Localiza os argumentos da linha de comando dentro de um determinado caminho.
PathGetCharType
Determina o tipo de caractere em relação a um caminho.
PathGetDriveNumber
Pesquisa um caminho para uma letra de unidade dentro do intervalo de 'A' a 'Z' e retorna o número da unidade correspondente.
PathIsContentType
Determina se o tipo de conteúdo registrado de um arquivo corresponde ao tipo de conteúdo especificado. Essa função obtém o tipo de conteúdo para o tipo de arquivo especificado e compara essa cadeia de caracteres com o pszContentType. A comparação não diferencia maiúsculas de minúsculas.
PathIsDirectory
Verifica se um caminho é um diretório válido.
PathIsDirectoryEmpty
Determina se um caminho especificado é um diretório vazio.
PathIsFileSpec
Pesquisa um caminho em busca de caracteres delimitadores de caminho (por exemplo, ':' ou '' ). Se não houver caracteres de delimitação de caminho presentes, o caminho será considerado um caminho de especificação de arquivo.
PathIsHTMLFile
Determina se um arquivo é um arquivo HTML. A determinação é feita com base no tipo de conteúdo registrado para a extensão do arquivo.
PathIsLFNFileSpec
Determina se um nome de arquivo está em formato longo.
Caminho é Caminho de Rede
Determina se uma cadeia de caracteres de caminho representa um recurso de rede.
PathIsPrefix
Pesquisa um caminho para determinar se ele contém um prefixo válido do tipo passado por pszPrefix. Um prefixo é um destes tipos: "C:\", ".", "..", ".. \".
PathIsRelative
Pesquisa um caminho e determina se ele é relativo.
PathIsRoot
Determina se uma string de caminho se refere à raiz de um volume.
PathIsSameRoot
Compara dois caminhos para determinar se eles têm um componente raiz comum.
PathIsSystemFolder
Determina se uma pasta existente contém os atributos que a tornam uma pasta do sistema. Como alternativa, essa função indica se determinados atributos qualificam uma pasta para ser uma pasta do sistema.
PathIsUNC
Determina se uma cadeia de caracteres de caminho é um caminho UNC (Convenção de Nomenclatura Universal) válido, em vez de um caminho baseado em uma letra de unidade.
PathIsUNCServer
Determina se uma cadeia de caracteres é um UNC válido apenas para um caminho de servidor.
PathIsUNCServerShare
Determina se uma cadeia de caracteres é um caminho de compartilhamento UNC válido, \server<em>share.
PathIsURL
Testa uma determinada cadeia de caracteres para determinar se ela está em conformidade com um formato de URL válido.
PathMakePretty
Converte um caminho totalmente maiúsculo em todos os caracteres minúsculos para dar ao caminho uma aparência consistente.
PastaPathMakeSystemPath
Dá a uma pasta existente os atributos adequados para se tornar uma pasta do sistema.
PathMatchSpec
Pesquisa uma cadeia de caracteres usando um tipo de correspondência curinga do MS-DOS.
CaminhoMatchSpecEx
Corresponde um nome de arquivo de um caminho a um ou mais padrões de nome de arquivo.
PathParseIconLocation
Analisa uma cadeia de caracteres de local de arquivo que contém um local de arquivo e um índice de ícone e retorna valores separados.
Espaços de citação de caminho
Pesquisa espaços em um caminho. Se forem encontrados espaços, todo o caminho será colocado entre aspas.
CaminhoRelativoPathTo
Cria um caminho relativo de um arquivo ou pasta para outro.
PathRemoveArgs
Remove todos os argumentos de um determinado caminho.
PathRemoveBackslash
Remove a barra invertida à direita de um determinado caminho.
Observação: essa função foi descontinuada. Recomendamos o uso da função PathCchRemoveBackslash ou PathCchRemoveBackslashEx em seu lugar.
PathRemoveBlanks
Remove todos os espaços à esquerda e à direita de uma cadeia de caracteres.
PathRemoveExtension
Remove a extensão de nome de arquivo de um caminho, se houver.
Observação: essa função foi descontinuada. Recomendamos o uso do PathCchRemoveExtension em seu lugar.
PathRemoveFileSpec
Remove o nome do arquivo à direita e a barra invertida de um caminho, se estiverem presentes.
Observação: essa função foi descontinuada. Recomendamos o uso da função PathCchRemoveFileSpec em seu lugar.
Extensão PathRenamePath
Substitui a extensão de um nome de arquivo por uma nova extensão. Se o nome do arquivo não contiver uma extensão, a extensão será anexada ao final da cadeia de caracteres.
Observação: o uso indevido dessa função pode levar a uma saturação do buffer. Recomendamos o uso da função PathCchRenameExtension mais segura em seu lugar.
CaminhoPesquisar e Qualificar
Determina se um determinado caminho está formatado corretamente e totalmente qualificado.
PathSetDlgItemPath
Define o texto de um controle filho em uma janela ou caixa de diálogo, usando PathCompactPath para garantir que o caminho se ajuste ao controle.
Raiz do PathSkipRoot
Recupera um ponteiro para o primeiro caractere em um caminho após a letra da unidade ou os elementos de caminho do servidor/compartilhamento UNC.
Caminho da Faixa
Remove a parte do caminho de um caminho e arquivo totalmente qualificados.
CaminhoStripToRoot
Remove todos os elementos de arquivo e diretório em um caminho, exceto as informações de raiz.
Observação: o uso indevido dessa função pode levar a uma saturação do buffer. Recomendamos o uso da função PathCchStripToRoot mais segura em seu lugar.
CaminhoDesdecorar
Remove a decoração de uma sequência de caminho.
PathUnExpandEnvStrings
Substitui determinados nomes de pasta em um caminho totalmente qualificado por sua cadeia de caracteres de ambiente associada.
Pasta_PathUnmakeSystemFolder
Remove os atributos de uma pasta que a tornam uma pasta do sistema. Essa pasta deve realmente existir no sistema de arquivos.
Espaços PathUnquote
Remove aspas do início e do fim de um caminho.
SHSkipJunction
Verifica um contexto de associação para ver se é seguro associar a um objeto de componente específico.
UrlApplyScheme
Determina um esquema para uma cadeia de caracteres de URL especificada e retorna uma cadeia de caracteres com um prefixo apropriado.
UrlCanonicalize
Converte uma cadeia de caracteres de URL em forma canônica.
Combinação de URL
Quando fornecido com um URL relativo e sua base, retorna um URL em formato canônico.
UrlComparar
Faz uma comparação que diferencia maiúsculas de minúsculas de duas cadeias de caracteres de URL.
UrlCreateFromPath
Converte um caminho do MS-DOS em uma URL canônica.
UrlEscape
Converte caracteres ou pares substitutos em uma URL que pode ser alterada durante o transporte pela Internet (caracteres "inseguros") em suas sequências de escape correspondentes. Pares substitutos são caracteres entre U+10000 a U+10FFFF (em UTF-32) ou entre DC00 a DFFF (em UTF-16).
UrlEscapeSpaces
Uma macro que converte caracteres de espaço em sua sequência de escape correspondente.
UrlGetLocation
Recupera o local de uma URL.
UrlGetPart
Aceita uma cadeia de caracteres de URL e retorna uma parte especificada dessa URL.
UrlHash
Hashes de uma string de URL.
UrlIs
Testa se uma URL é um tipo especificado.
UrlIsFileUrl
Testa uma URL para determinar se ela é uma URL de arquivo.
UrlIsNoHistory
Retorna se uma URL é uma URL que os navegadores normalmente não incluem no histórico de navegação.
UrlIsOpaque
Retorna se uma URL é opaca.
UrlUnescape
Converte sequências de escape de volta em caracteres comuns.
UrlUnescapeInPlace
Converte sequências de escape de volta em caracteres comuns e substitui a cadeia de caracteres original.