Método IKnownFolder::GetFolderDefinition (shobjidl_core.h)
Recupera una estructura que contiene los elementos que definen una carpeta conocida, que incluye la categoría, el nombre, la ruta de acceso, la descripción, la información sobre herramientas, el icono y otras propiedades.
Sintaxis
HRESULT GetFolderDefinition(
[out] KNOWNFOLDER_DEFINITION *pKFD
);
Parámetros
[out] pKFD
Tipo: KNOWNFOLDER_DEFINITION*
Cuando este método devuelve , contiene un puntero a la estructura KNOWNFOLDER_DEFINITION . Cuando ya no es necesario, la aplicación que realiza la llamada es responsable de llamar a FreeKnownFolderDefinitionFields para liberar este recurso.
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.
Comentarios
Cuando una aplicación de terceros crea su propia carpeta conocida, lo hace definiendo con una estructura de KNOWNFOLDER_DEFINITION y registrándola con el sistema. Cualquier información de definición de carpeta conocida registrada (proporcionada por el sistema o creada por la aplicación) se puede recuperar a través de este método.
Para llamar a este método, el autor de la llamada debe tener al menos privilegios de usuario.
Requisitos
| 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) |