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.

Requisitos