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

Obtiene un objeto que representa una carpeta conocida identificada por su KNOWNFOLDERID. 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 GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

Parámetros

[in] rfid

Tipo: REFKNOWNFOLDERID

Referencia a KNOWNFOLDERID.

[out] ppkf

Tipo: IKnownFolder**

Cuando este método vuelve, contiene un puntero de interfaz al objeto IKnownFolder que representa la carpeta.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error, incluido lo siguiente:

Código devuelto	Descripción
E_INVALIDARG	Entre otras cosas, este valor puede indicar que el parámetro rfid hace referencia a un KNOWNFOLDERID que no está presente en el sistema. No todos los valores KNOWNFOLDERID están presentes en todos los sistemas. Use IKnownFolderManager::GetFolderIds para recuperar el conjunto de valores KNOWNFOLDERID para el sistema actual.

Comentarios

Para llamar a este método, el autor de la llamada debe tener al menos privilegios de usuario.

Cuándo usar

Use este método cuando sepa exactamente qué carpeta conocida busca y desea acceder a ella directamente.

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 (incluya Shobjidl.h)
Archivo DLL	Shell32.dll

Consulte también

IKnownFolderManager

Ejemplo de carpetas conocidas