Função SHGetPathFromIDListW (shlobj_core.h)

Artigo
11/20/2024

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 relativo à 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.

Valor de retorno

Tipo: BOOL

Retorna verdadeiro se bem-sucedido; caso contrário, FALSE .

Observações

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.

Nota

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 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 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	shlobj_core.h (inclua Shlobj.h, Shlobj_core.h)
biblioteca	Shell32.lib
de DLL	Shell32.dll (versão 4.0 ou posterior)
conjunto de API	ext-ms-win-shell-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)

Consulte também

SHGetPathFromIDListEx

SHParseDisplayName

Compartilhar via