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

Obtiene un objeto que representa una carpeta conocida basada en una ruta de acceso del sistema de archivos. El objeto permite consultar determinadas propiedades de carpeta, obtener la ruta de acceso actual de la carpeta, redirigir la carpeta a otra ubicación y obtener la ruta de acceso de la carpeta como ITEMIDLIST.

Sintaxis

HRESULT FindFolderFromPath(
  [in]  LPCWSTR      pszPath,
  [in]  FFFP_MODE    mode,
  [out] IKnownFolder **ppkf
);

Parámetros

[in] pszPath

Tipo: LPCWSTR

Puntero a una cadena Unicode terminada en null de longitud MAX_PATH que contiene una ruta de acceso a una carpeta conocida.

[in] mode

Tipo: FFFP_MODE

Uno de los siguientes valores que especifican la precisión de la coincidencia de la ruta de acceso y la carpeta conocida:

FFFP_EXACTMATCH

Recupere solo la carpeta conocida específica de la ruta de acceso del archivo especificada.

FFFP_NEARESTPARENTMATCH

Si no se encuentra una coincidencia exacta para la ruta de acceso del archivo especificada, recupere la primera carpeta conocida que coincida con una de sus carpetas primarias que recorren el árbol primario.

[out] ppkf

Tipo: IKnownFolder**

Cuando este método finaliza, contiene la dirección de un puntero al objeto IKnownFolder que representa la carpeta conocida.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)
Archivo DLL	Shell32.dll

Consulte también

IKnownFolderManager

Ejemplo de carpetas conocidas