Метод IShellDetails::GetDetailsOf (shlobj_core.h)

Получает подробные сведения об элементе в папке оболочки.

Синтаксис

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

Параметры

[in, optional] pidl

Тип: PCUITEMID_CHILD

PiDL элемента, для которых запрашиваются сведения. Если этот параметр имеет значение NULL, заголовок поля сведений, заданного iColumn , будет возвращен в структуре SHELLDETAILS , на которую указывает pDetails.

iColumn

Тип: UINT

Отсчитываемый от нуля индекс требуемого информационного поля. Он идентичен номеру столбца сведений, которые отображаются в представлении Сведений о Обозреватель Windows.

[out] pDetails

Тип: SHELLDETAILS*

Указатель на структуру SHELLDETAILS с подробными сведениями.

Возвращаемое значение

Тип: HRESULT

В случае успешного выполнения возвращает S_OK. Возвращает E_FAIL, если iColumn превышает количество столбцов, поддерживаемых папкой. В противном случае возвращает стандартный код ошибки COM.

Комментарии

Этот метод был заменен методами IShellFolder2 для оболочки версии 5.0 и более поздних версий.

Метод IShellDetails::GetDetailsOf предоставляет доступ к сведениям, отображаемым в представлении Windows Обозреватель Details папки оболочки. Номера столбцов, заголовки столбцов и сведения об элементах, отображаемые в представлении Сведений, идентичны номерам, возвращаемым IShellDetails::GetDetailsOf.

Доступные информационные поля и их номера столбцов зависят от конкретной папки. Для перечисления доступных полей вызовите метод IShellDetails::GetDetailsOf с pidl , имеющим значение NULL для увеличения значений iColumn. Этот подход предоставляет заголовок, связанный с каждым индексом столбца. Если iColumn превышает число столбцов, поддерживаемых папкой, IShellDetails::GetDetailsOf вернет E_FAIL. Имейте в виду, что эти названия можно локализовать и могут отличаться для всех языковых стандартов.

Папки файловой системы имеют большой стандартный набор полей сведений. Первые четыре поля являются стандартными для всех папок файловой системы.

Индекс столбца	Заголовок столбца
0	Имя
1	Размер
2	Тип
3	Дата изменения

 

Папки файловой системы могут поддерживать ряд дополнительных полей. Однако они не требуются для этого, и индексы столбцов, назначенные этим полям, могут отличаться.

Каждая виртуальная папка имеет собственный уникальный набор информационных полей. Как правило, отображаемое имя элемента находится в нулевом столбце, но порядок и содержимое доступных полей зависят от реализации конкретного объекта папки.

Примечание для разработчиков

Объекты folder должны реализовывать IShellFolder2 вместо этого интерфейса.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h
DLL	Shell32.dll (версия 5.0 или более поздняя)