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.
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. |