Compartir a través de

Método IShellDetails::GetDetailsOf (shlobj_core.h)

  • Artículo

Obtiene información detallada sobre un elemento de una carpeta shell.

Sintaxis

HRESULT GetDetailsOf(
  [in, optional] PCUITEMID_CHILD pidl,
                 UINT            iColumn,
  [out]          SHELLDETAILS    *pDetails
);

Parámetros

[in, optional] pidl

Tipo: PCUITEMID_CHILD

PIDL del elemento para el que solicita información. Si este parámetro se establece en NULL, el título del campo de información especificado por iColumn se devolverá en la estructura SHELLDETAILS a la que apunta pDetails.

iColumn

Tipo: UINT

Índice de base cero del campo de información deseado. Es idéntico al número de columna de la información que se muestra en una vista Detalles del Explorador de Windows.

[out] pDetails

Tipo: SHELLDETAILS*

Puntero a una estructura SHELLDETAILS con la información detallada.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente. Devuelve E_FAIL si iColumn supera el número de columnas admitidas por la carpeta. De lo contrario, devuelve un código de error COM estándar.

Comentarios

Este método se ha reemplazado por los métodos de IShellFolder2 para shell versión 5.0 y posteriores.

El método IShellDetails::GetDetailsOf proporciona acceso a la información que se muestra en la vista Detalles del Explorador de Windows de una carpeta shell. Los números de columna, los títulos de columna y la información de elementos que ve en la vista Detalles son idénticos a los devueltos por IShellDetails::GetDetailsOf.

Los campos de información disponibles y sus números de columna varían en función de la carpeta determinada. Para enumerar los campos disponibles, llame a IShellDetails::GetDetailsOf con pidl establecido en NULL para aumentar los valores de iColumn. Este enfoque proporciona el título asociado a cada índice de columna. Cuando iColumn supera el número de columnas admitidas por la carpeta, IShellDetails::GetDetailsOf devolverá E_FAIL. Tenga en cuenta que estos títulos son localizables y es posible que no sean los mismos para todas las configuraciones regionales.

Las carpetas del sistema de archivos tienen un gran conjunto estándar de campos de información. Los cuatro primeros campos son estándar para todas las carpetas del sistema de archivos.

Índice de columna Título de columna
0 Nombre
1 Size
2 Tipo
3 Fecha de modificación
 

Las carpetas del sistema de archivos pueden admitir varios campos adicionales. Sin embargo, no son necesarios para hacerlo y los índices de columna asignados a estos campos pueden variar.

Cada carpeta virtual tiene su propio conjunto único de campos de información. Normalmente, el nombre para mostrar del elemento está en la columna cero, pero el orden y el contenido de los campos disponibles dependen de la implementación del objeto de carpeta en particular.

Nota para los implementadores

Los objetos folder deben implementar IShellFolder2 en lugar de esta interfaz.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h
Archivo DLL Shell32.dll (versión 5.0 o posterior)