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 值的指针，当此函数成功返回时，该 DWORD 值接收一个或多个 SFGAO 标志，这些标志指示 pdo 中所有项所请求的属性。 如果不需要此信息，则此指针可以为 NULL 。

[out, optional] pcItems

类型： UINT*

指向 UINT 的指针，此函数成功返回时，接收 pdo 指向的数据对象中的 PIDL 数。 如果不需要此信息，则此指针可以为 NULL 。

返回值

类型： HRESULT

此函数可以返回其中一个值。

返回代码	说明
S_OK	成功。
S_FALSE	对象不是系统数据对象。 在这种情况下， pdwAttributes 设置为 0。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	shlobj_core.h (包括 Shlobj.h)
Library	Shell32.lib
DLL	Shell32.dll (6.0 或更高版本)