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

Функция SHGetAttributesFromDataObject (shlobj_core.h)

  • Статья

[SHGetAttributesFromDataObject доступен для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Извлекает указанные фрагменты информации из объекта системных данных.

Синтаксис

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

Параметры

[in, optional] pdo

Тип: IDataObject*

Объект данных, из которого извлекаются сведения.

dwAttributeMask

Тип: DWORD

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

[out, optional] pdwAttributes

Тип: DWORD*

Указатель на значение DWORD , которое при успешном возврате этой функцией получает один или несколько флагов SFGAO , указывающих среди запрошенных атрибутов, которые являются общими для всех элементов в PDO. Этот указатель может иметь значение NULL , если эти сведения не требуются.

[out, optional] pcItems

Тип: UINT*

Указатель на UINT , который при успешном возврате этой функции получает количество PIDLs в объекте данных, на который указывает pdo. Этот указатель может иметь значение NULL , если эти сведения не требуются.

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

Тип: HRESULT

Эта функция может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
S_FALSE
 Объект не является объектом системных данных. В этом случае для pdwAttributes задано значение 0.

Требования

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