Função PathFindOnPathW (shlwapi.h)

Pesquisa um arquivo.

Sintaxe

BOOL PathFindOnPathW(
  [in, out]      LPWSTR   pszPath,
  [in, optional] PZPCWSTR ppszOtherDirs
);

Parâmetros

[in, out] pszPath

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres de comprimento terminada em nulo 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

Retorna 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