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

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

Nesta secçã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. Nota: O uso indevido desta função pode levar a uma sobrecarga da memória intermédia. Recomendamos o uso do mais seguro PathCchAddBackslash ou função de PathCchAddBackslashEx em seu lugar.
PathAddExtension	Adiciona uma extensão de nome de arquivo a uma cadeia de caracteres de caminho. Nota: O uso indevido desta função pode levar a uma sobrecarga da memória intermédia. Recomendamos o uso da função demais seguraPathCchAddExtension em seu lugar.
PathAppend	Acrescenta um caminho ao final de outro. Nota: O uso indevido desta função pode levar a uma sobrecarga da memória intermédia. Recomendamos o uso da função mais segura PathCchAppend ou PathCchAppendEx em seu lugar.
PathBuildRoot	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.
PathCombine	Concatena duas cadeias de caracteres que representam caminhos devidamente formados em um caminho; também concatena quaisquer elementos de caminho relativos. Nota: O uso indevido desta função pode levar a uma sobrecarga da memória intermédia. Recomendamos o uso do mais seguro PathCchCombine ou função de PathCchCombineEx em seu lugar.
PathCommonPrefix	Compara dois caminhos para determinar se eles compartilham um prefixo comum. Um prefixo é um destes tipos: "C:\", ".", "..", ".. \".
PathCompactPath	Trunca um caminho de arquivo para caber dentro de uma determinada largura de pixel substituindo componentes de caminho por reticências.
PathCompactPathEx	Trunca um caminho para caber dentro de um determinado número de caracteres substituindo componentes de 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.
PathFindExtension	Pesquisa um caminho para uma extensão.
PathFindFileName	Pesquisa um caminho para um nome de arquivo.
PathFindNextComponent	Analisa um caminho e retorna a parte desse caminho que segue a primeira barra invertida.
PathFindOnPath	Procura um ficheiro.
PathFindSuffixArray	Determina se um determinado nome de arquivo tem um de uma lista de sufixos.
PathGetArgs	Localiza os argumentos de linha de comando dentro de um determinado caminho.
PathGetCharType	Determina o tipo de caractere em relação a um caminho.
PathGetDriveNumber	Procura um caminho para uma letra de unidade dentro do intervalo de 'A' a 'Z' e retorna o número de unidade correspondente.
PathIsContentType	Determina se o tipo de conteúdo registrado de um arquivo corresponde ao tipo de conteúdo especificado. Esta 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	Procura um caminho para quaisquer caracteres de delimitação 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.
PathIsNetworkPath	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 cadeia de caracteres 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 certos atributos qualificam uma pasta para ser uma pasta do sistema.
PathIsUNC	Determina se uma cadeia de caracteres de caminho é um caminho UNC (Convenção Universal de Nomenclatura) válido, em oposição a 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.
PathMakeSystemFolder	Fornece 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 MS-DOS.
PathMatchSpecEx	Faz a correspondência entre um nome de arquivo de um caminho e 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.
PathQuoteSpaces	Pesquisa um caminho para espaços. Se forem encontrados espaços, todo o caminho será colocado entre aspas.
PathRelativePathTo	Cria um caminho relativo de um arquivo ou pasta para outro.
PathRemoveArgs	Remove quaisquer argumentos de um determinado caminho.
PathRemoveBackslash	Remove a barra invertida à direita de um determinado caminho. Nota: Esta função foi preterida. Recomendamos o uso do PathCchRemoveBackslash ou função de 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 um. Nota: Esta função foi preterida. 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. Nota: Esta função foi preterida. Recomendamos o uso da funçãoPathCchRemoveFileSpec em seu lugar.
PathRenameExtension	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. Nota: O uso indevido desta função pode levar a uma sobrecarga da memória intermédia. Recomendamos o uso da função demais seguraPathCchRenameExtension em seu lugar.
PathSearchAndQualify	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 encaixe no controle.
PathSkipRoot	Recupera um ponteiro para o primeiro caractere em um caminho após a letra da unidade ou os elementos de caminho de servidor/compartilhamento UNC.
PathStripPath	Remove a parte do caminho de um caminho e arquivo totalmente qualificados.
PathStripToRoot	Remove todos os elementos de arquivo e diretório em um caminho, exceto as informações de raiz. Nota: O uso indevido desta função pode levar a uma sobrecarga da memória intermédia. Recomendamos o uso da função demais seguraPathCchStripToRoot em seu lugar.
PathUndecorate	Remove a decoração de uma cadeia de caracteres de caminho.
PathUnExpandEnvStrings	Substitui determinados nomes de pasta em um caminho totalmente qualificado por sua cadeia de caracteres de ambiente associada.
PathUnmakeSystemFolder	Remove os atributos de uma pasta que a tornam uma pasta do sistema. Esta pasta deve realmente existir no sistema de arquivos.
PathUnquoteSpaces	Remove aspas do início e do fim de um caminho.
SHSkipJunction	Verifica um contexto de associação para ver se é seguro vincular 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 formato canônico.
UrlCombine	Quando fornecido com um URL relativo e sua base, retorna um URL em forma canônica.
UrlCompare	Faz uma comparação que diferencia maiúsculas de minúsculas de duas cadeias de caracteres de URL.
UrlCreateFromPath	Converte um caminho MS-DOS em uma URL canonicalizada.
UrlEscape	Converte caracteres ou pares substitutos em um URL que pode ser alterado durante o transporte pela Internet (caracteres "não seguros") 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 uma cadeia de caracteres de URL.
UrlIs	Testa se uma URL é um tipo especificado.
UrlIsFileUrl	Testa uma URL para determinar se é 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 fuga de volta em caracteres comuns.
UrlUnescapeInPlace	Converte sequências de escape de volta em caracteres comuns e substitui a cadeia de caracteres original.