Compartir a través de

Método IShellFolder2::GetDetailsOf (shobjidl_core.h)

  • Artículo

Obtiene información detallada, identificada por un índice de columna, en un elemento de una carpeta shell.

Sintaxis

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

Parámetros

[in] pidl

Tipo: PCUITEMID_CHILD

PIDL del elemento para el que solicita información. Este método solo acepta PIDL de nivel único. La estructura debe contener exactamente una estructura SHITEMID seguida de un cero de terminación. Si este parámetro se establece en NULL, se devuelve el título del campo de información especificado por iColumn .

[in] 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] psd

Tipo: SHELLDETAILS*

Puntero a una estructura SHELLDETAILS que contiene la información.

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

El método IShellFolder2::GetDetailsOf es idéntico a GetDetailsOf. Para obtener una manera más sólida de recuperar información de elementos que no requiere conocer el índice de columna, use IShellFolder2::GetDetailsEx.

El método IShellFolder2::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 encabezados y la información que ve en la vista Detalles son idénticos a los de IShellFolder2::GetDetailsOf. Tenga en cuenta que los campos de información disponibles y sus números de columna varían en función de la carpeta determinada. Puede enumerar los campos disponibles llamando a este método con pidl establecido en NULL y examinando el título asociado a cada índice de columna. Tenga en cuenta que estos títulos se pueden localizar y es posible que no sean los mismos para todas las configuraciones regionales.

Las carpetas del sistema de archivos tienen un conjunto grande y 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 restantes dependen de la implementación del objeto de carpeta determinado.

Requisitos

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