Função SHILCreateFromPath (shlobj_core.h)

[SHILCreateFromPath está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, os aplicativos devem usar SHParseDisplayName ]

Cria um ponteiro para uma lista de identificadores de item (PIDL) de um caminho.

Sintaxe

SHSTDAPI SHILCreateFromPath(
  [in]                PCWSTR           pszPath,
  [out]               PIDLIST_ABSOLUTE *ppidl,
  [in, out, optional] DWORD            *rgfInOut
);

Parâmetros

[in] pszPath

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o caminho a ser convertido.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

O caminho no pszPath expresso como um PIDL.

[in, out, optional] rgfInOut

Tipo: DWORD*

Um ponteiro para um valor DWORD que, na entrada, indica todos os atributos da pasta nomeada em pszPath que o aplicativo de chamada gostaria de recuperar junto com o PIDL. Na saída, esse valor contém esses atributos solicitados. Para obter uma lista de possíveis sinalizadores de atributo para esse parâmetro, consulte IShellFolder::GetAttributesOf.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

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-1 (introduzido no Windows 10, versão 10.0.10240)