Função PathFindOnPathA (shlwapi.h)

Artigo
11/20/2024

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 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 e terminada em nulo de diretórios a ser pesquisada primeiro. Esse valor pode ser NULL.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

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 uma gama mais ampla 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Compartilhar via