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

Obtém um objeto que representa uma pasta conhecida com base em um caminho do sistema de arquivos. 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 FindFolderFromPath(
  [in]  LPCWSTR      pszPath,
  [in]  FFFP_MODE    mode,
  [out] IKnownFolder **ppkf
);

Parâmetros

[in] pszPath

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo de comprimento MAX_PATH que contém um caminho para uma pasta conhecida.

[in] mode

Tipo: FFFP_MODE

Um dos seguintes valores que especificam a precisão da correspondência do caminho e da pasta conhecida:

FFFP_EXACTMATCH

Recupere apenas a pasta conhecida específica para o caminho de arquivo fornecido.

FFFP_NEARESTPARENTMATCH

Se uma correspondência exata não for encontrada para o caminho do arquivo fornecido, recupere a primeira pasta conhecida que corresponde a uma de suas pastas pai subindo a árvore pai.

[out] ppkf

Tipo: IKnownFolder**

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

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.

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