Função SHGetPathFromIDListW (shlobj_core.h)

  • Artigo

Converte uma lista de identificadores de item em um caminho do sistema de arquivos.

Sintaxe

BOOL SHGetPathFromIDListW(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPWSTR            pszPath
);

Parâmetros

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

O endereço de uma lista de identificadores de item que especifica um arquivo ou local de diretório em relação à raiz do namespace (a área de trabalho).

[out] pszPath

Tipo: LPTSTR

O endereço de um buffer para receber o caminho do sistema de arquivos. Esse buffer deve ter pelo menos MAX_PATH caracteres de tamanho.

Retornar valor

Tipo: BOOL

Retorna TRUE se tiver êxito; caso contrário, FALSE.

Comentários

Se o local especificado pelo parâmetro pidl não fizer parte do sistema de arquivos, essa função falhará.

Se o parâmetro pidl especificar um atalho, o pszPath conterá o caminho para o atalho, não para o destino do atalho.

Observação

O cabeçalho shlobj_core.h define SHGetPathFromIDList 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 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 shlobj_core.h (inclua Shlobj.h, Shlobj_core.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 4.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

SHGetPathFromIDListEx

SHParseDisplayName