Método IKnownFolder::GetIDList (shobjidl_core.h)

  • Artigo

Obtém o local da pasta namespace Shell no formulário IDList (ITEMIDLIST).

Sintaxe

HRESULT GetIDList(
  [in]  DWORD            dwFlags,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parâmetros

[in] dwFlags

Tipo: DWORD

Sinalizadores que especificam opções de recuperação especiais. Esse valor pode ser 0; caso contrário, um ou mais dos valores KNOWN_FOLDER_FLAG .

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

Quando esse método retorna, contém o endereço de um PIDL absoluto. Este parâmetro é passado não inicializado. O aplicativo de chamada é responsável por liberar esse recurso quando ele não é mais necessário.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Equivalente a SHGetKnownFolderIDList.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll

Confira também

IKnownFolder

Exemplo de pastas conhecidas

SHGetKnownFolderIDList