Compartilhar via

Função SHCloneSpecialIDList (shlobj_core.h)

  • Artigo

[SHCloneSpecialIDList 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, use SHGetSpecialFolderLocation.]

Recupera um ponteiro para a estrutura ITEMIDLIST que especifica uma pasta especial.

Sintaxe

PIDLIST_ABSOLUTE SHCloneSpecialIDList(
       HWND hwnd,
  [in] int  csidl,
  [in] BOOL fCreate
);

Parâmetros

hwnd

Digite: HWND

Reservado.

[in] csidl

Tipo: int

Um valor CSIDL que identifica a pasta de interesse.

[in] fCreate

Tipo: BOOL

Um valor do tipo BOOL que indica se a pasta deve ser criada se ela ainda não existir. Se fCreate for TRUE, a pasta será criada. Se for FALSE, a pasta não será criada.

Retornar valor

Tipo: PIDLIST_ABSOLUTE

Retorna um ponteiro para a estrutura ITEMIDLIST de uma pasta especial especificada por csidl. A função criará a pasta se fCreate for TRUE.

Comentários

Quando terminar, você deverá liberar o ponteiro para a pasta clonada com ILFree.

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