Compartilhar via


Método IKnownFolderManager::GetFolder (shobjidl_core.h)

Obtém um objeto que representa uma pasta conhecida identificada por seu KNOWNFOLDERID. O objeto permite consultar determinadas propriedades de pasta, obter o caminho atual da pasta, redirecionar a pasta para outro local e obter o caminho da pasta como ITEMIDLIST.

Sintaxe

HRESULT GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

Parâmetros

[in] rfid

Tipo: REFKNOWNFOLDERID

Referência ao KNOWNFOLDERID.

[out] ppkf

Tipo: IKnownFolder**

Quando esse método retorna, contém um ponteiro de interface para o objeto IKnownFolder que representa a pasta.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, incluindo o seguinte:

Código de retorno Descrição
E_INVALIDARG
Entre outras coisas, esse valor pode indicar que o parâmetro rfid faz referência a um KNOWNFOLDERID que não está presente no sistema. Nem todos os valores KNOWNFOLDERID estão presentes em todos os sistemas. Use IKnownFolderManager::GetFolderIds para recuperar o conjunto de valores KNOWNFOLDERID para o sistema atual.

Comentários

Para chamar esse método, o chamador deve ter pelo menos privilégios de usuário.

Quando usar

Use esse método quando souber exatamente qual pasta conhecida você está procurando e quiser acessá-la diretamente.

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

IKnownFolderManager

Exemplo de pastas conhecidas