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

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

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

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

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

Требования