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


Метод IColumnProvider::GetItemData (shlobj.h)

Запрашивает данные столбца для указанного файла.

Синтаксис

HRESULT GetItemData(
  [in]  LPCSHCOLUMNID   pscid,
  [in]  LPCSHCOLUMNDATA pscd,
  [out] VARIANT         *pvarData
);

Параметры

[in] pscid

Тип: LPCSHCOLUMNID

Структура SHCOLUMNID , идентифицирующая столбец.

[in] pscd

Тип: LPCSHCOLUMNDATA

Структура SHCOLUMNDATA , задающая файл.

[out] pvarData

Тип: VARIANT*

Указатель на VARIANT с данными для файла, указанного pscd , который принадлежит к столбцу, указанному pscid. Задайте это значение, если файл является членом класса, поддерживаемого поставщиком столбцов.

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

Тип: HRESULT

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

Комментарии

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

Этот метод вызывается для каждого файла, отображаемого windows Обозреватель, хотя многие из них не будут поддерживаться определенным поставщиком столбцов. Чтобы повысить производительность, сначала проверка элемент pwszExt структуры, на который указывает pscd, чтобы узнать, есть ли у него расширение имени файла, поддерживаемое поставщиком столбцов. В противном случае избегайте ненужной обработки, немедленно возвращая S_FALSE.

Требования

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