Метод 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, и проверив заголовок, связанный с каждым индексом столбца. Имейте в виду, что эти названия могут быть локализованы и могут не совпадать для всех языковых стандартов.

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

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

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

Требования