共用方式為

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 的指標，當此函式成功傳回時，會接收 pdo 所指向之數據物件中的 PIDL 數目。 如果不需要這項資訊，此指標可以是 NULL 。

傳回值

類型： HRESULT

此函式可以傳回其中一個值。

傳回碼 描述
S_OK
 成功。
S_FALSE
 物件不是系統數據物件。 在此情況下， pdwAttributes 會設定為 0。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 shlobj_core.h (包含 Shlobj.h)
程式庫 Shell32.lib
Dll Shell32.dll (6.0 版或更新版本)