Função PathResolve (shlobj_core.h)

[PathResolve está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Converte um nome de caminho relativo ou não qualificado em um nome de caminho totalmente qualificado.

Sintaxe

int PathResolve(
  [in, out]      PWSTR    pszPath,
  [in, optional] PZPCWSTR dirs,
                 UINT     fFlags
);

Parâmetros

[in, out] pszPath

Tipo: PWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém o caminho para resolve. Quando a função retorna, a cadeia de caracteres contém o caminho totalmente qualificado correspondente. Esse buffer deve ter pelo menos MAX_PATH caracteres.

[in, optional] dirs

Tipo: PZPCWSTR

Um ponteiro para uma matriz opcional terminada em nulo de diretórios a serem pesquisados primeiro, caso o caminho não possa ser resolvido do pszPath. Esse valor pode ser NULL.

fFlags

Tipo: UINT

Sinalizadores que especificam como a função opera.

PRF_VERIFYEXISTS

Retornar TRUE se a existência do arquivo for verificada; caso contrário , FALSE.

PRF_TRYPROGRAMEXTENSIONS

Procure o caminho especificado com as seguintes extensões acrescentadas: .pif, .com, .bat, .cmd, .lnk e .exe.

PRF_FIRSTDIRDEF

Procure primeiro no diretório ou diretórios especificados por dirs.

PRF_DONTFINDLNK

Ignore .lnk arquivos.

PRF_REQUIREABSOLUTE

Exigir um caminho absoluto (completo).

Retornar valor

Tipo: int

Retorna TRUE, a menos que PRF_VERIFYEXISTS esteja definido. Se esse sinalizador for definido, a função retornará TRUE se o arquivo for verificado para existir e FALSE caso contrário. Ele também define um código de erro ERROR_FILE_NOT_FOUND que você pode recuperar chamando GetLastError.

Comentários

Um valor retornado FALSE não significa necessariamente que o arquivo não existe. Isso pode significar que a função simplesmente não consegue localizar o arquivo das informações fornecidas.

Se PathResolve não puder resolve o caminho especificado em pszPath, ele chamará PathFindOnPath usando pszPath e dirs como os parâmetros.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)
Conjunto de APIs	ext-ms-win-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)

Confira também

PathFindOnPath