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) |