Função SHSimpleIDListFromPath (shobjidl_core.h)

  • Artigo

Preterido. Retorna um ponteiro para uma estrutura ITEMIDLIST quando passado um caminho.

Sintaxe

PIDLIST_ABSOLUTE SHSimpleIDListFromPath(
  [in] PCWSTR pszPath
);

Parâmetros

[in] pszPath

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho a ser convertido em um PIDL.

Retornar valor

Tipo: PIDLIST_ABSOLUTE

Retorna um ponteiro para uma estrutura ITEMIDLIST se tiver êxito ou NULL caso contrário.

Comentários

Antes do Windows 7, essa função era declarada em Shlobj.h. No Windows 7 e versões posteriores, ele é declarado em Shobjidl.h.

Nota Essa função está disponível por meio do Windows 7 e do Windows Server 2003. É possível que ele não esteja presente em versões futuras do Windows.
 
Uma alternativa a essa função é a seguinte:
  1. Chame SHGetDesktopFolder para obter IShellFolder para a pasta da área de trabalho.
  2. Obtenha o contexto de associação do IShellFolder (IBindCtx).
  3. Chame IShellFolder::P arseDisplayName com o IBindCtx e o caminho.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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 shobjidl_core.h (inclua Shobjidl.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.00 ou posterior)
Conjunto de APIs ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)