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

Статья
06/21/2023

[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 или более поздняя)

Share via