Função PathFindOnPathA (shlwapi.h)

Pesquisa um arquivo.

Sintaxe

BOOL PathFindOnPathA(
  [in, out]      LPSTR   pszPath,
  [in, optional] PZPCSTR ppszOtherDirs
);

Parâmetros

[in, out] pszPath

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento MAX_PATH que contém o nome do arquivo para o qual pesquisar. Se a pesquisa for bem-sucedida, esse parâmetro será usado para retornar o nome do caminho totalmente qualificado.

[in, optional] ppszOtherDirs

Tipo: LPCTSTR*

Uma matriz opcional terminada em nulo de diretórios a serem pesquisados primeiro. Esse valor pode ser NULL.

Retornar valor

Tipo: BOOL

Retornará TRUE se tiver êxito ou FALSE caso contrário.

Comentários

PathFindOnPath pesquisa o arquivo especificado por pszFile. Se nenhum diretório for especificado em ppszOtherDirs, ele tentará localizar o arquivo pesquisando diretórios padrão, como System32 e os diretórios especificados na variável de ambiente PATH. Para agilizar o processo ou habilitar PathFindOnPath para pesquisar um intervalo mais amplo de diretórios, use o parâmetro ppszOtherDirs para especificar um ou mais diretórios a serem pesquisados primeiro. Se mais de um arquivo tiver o nome especificado por pszFile, PathFindOnPath retornará a primeira instância encontrada.

Observação

O cabeçalho shlwapi.h define PathFindOnPath como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 4.71 ou posterior)