Função SHGetSpecialFolderLocation (shlobj_core.h)

[SHGetSpecialFolderLocation não tem suporte e pode ser alterado ou indisponível no futuro. Em vez disso, use SHGetFolderLocation.]

Recupera um ponteiro para a estrutura ITEMIDLIST de uma pasta especial.

Sintaxe

HRESULT SHGetSpecialFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parâmetros

[in] hwnd

Digite: HWND

Reservado.

[in] csidl

Tipo: int

Um valor CSIDL que identifica a pasta de interesse.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

Um PIDL que especifica o local da pasta em relação à raiz do namespace (a área de trabalho). É responsabilidade do aplicativo de chamada liberar o IDList retornado usando CoTaskMemFree.

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 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	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 4.0 ou posterior)
Conjunto de APIs	ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Shgetspecialfolderpath