Função SHGetPathFromIDListEx (shlobj_core.h)

Converte uma lista de identificadores de item em um caminho do sistema de arquivos. Essa função estende SHGetPathFromIDList , permitindo que você defina o tamanho inicial do buffer de cadeia de caracteres e declare as opções abaixo.

Sintaxe

BOOL SHGetPathFromIDListEx(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] PWSTR             pszPath,
        DWORD             cchPath,
        GPFIDL_FLAGS      uOpts
);

Parâmetros

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

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

[out] pszPath

Tipo: PWSTR

Quando essa função é chamada, é passado um buffer Unicode terminado em nulo para receber o caminho do sistema de arquivos. Esse buffer é de tamanho cchPath.

Quando essa função retorna, contém o endereço de um buffer Unicode terminado em nulo que contém o caminho do sistema de arquivos. Esse buffer é de tamanho cchPath.

cchPath

Tipo: DWORD

O tamanho do buffer apontado por pszPath, em caracteres.

uOpts

Tipo: GPFIDL_FLAGS

Esses sinalizadores determinam o tipo de caminho retornado.

GPFIDL_DEFAULT (0x0000)

Nomes de arquivo, servidores e unidades raiz do Win32 estão incluídos.

GPFIDL_ALTNAME (0x0001)

Usa nomes de arquivo curtos.

GPFIDL_UNCPRINTER (0x0002)

Inclua itens de nomes de impressora UNC.

Retornar valor

Tipo: BOOL

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

Comentários

Exceto para nomes de impressora UNC, 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.

Requisitos

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

Confira também

SHParseDisplayName