Поделиться через


Метод IShellFolder2::GetDetailsOf (shobjidl_core.h)

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

Синтаксис

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

Параметры

[in] pidl

Тип: PCUITEMID_CHILD

PIDL элемента, для которого запрашиваются сведения. Этот метод принимает только одноуровневые PID-файлы. Структура должна содержать ровно одну структуру SHITEMID , за которой следует завершающий ноль. Если для этого параметра задано значение NULL, возвращается заголовок поля сведений, заданного iColumn .

[in] iColumn

Тип: UINT

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

[out] psd

Тип: SHELLDETAILS*

Указатель на структуру SHELLDETAILS , содержащую сведения.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Метод IShellFolder2::GetDetailsOf идентичен методу GetDetailsOf. Для более надежного способа получения сведений об элементах, не требующих знания индекса столбца, используйте IShellFolder2::GetDetailsEx.

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

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

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

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

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

Требования

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