IShellFolder2::GetDetailsOf 方法 (shobjidl_core.h)

取得Shell資料夾中項目上資料行索引所識別的詳細資訊。

語法

HRESULT GetDetailsOf(
  [in]  PCUITEMID_CHILD pidl,
  [in]  UINT            iColumn,
  [out] SHELLDETAILS    *psd
);

參數

[in] pidl

類型: PCUITEMID_CHILD

您要要求資訊之專案的 PIDL。 這個方法只接受單一層級的 PIDL。 結構必須只包含一個 SHITEMID 結構,後面接著終止零。 如果此參數設定為 NULL,則會傳回 iColumn 所指定資訊欄位的標題。

[in] iColumn

類型: UINT

所需資訊欄位之以零起始的索引。 它與 Windows 檔案總管詳細數據檢視中顯示的資訊列號相同。

[out] psd

類型: SHELLDETAILS*

包含資訊的SHELLDETAILS結構的指標。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

IShellFolder2::GetDetailsOf 方法與 GetDetailsOf 相同。 如需更健全的方式來擷取不需要您知道數據行索引的項目資訊,請使用 IShellFolder2::GetDetailsEx

IShellFolder2::GetDetailsOf 方法可讓您存取 Shell 資料夾之 Windows 檔案總管詳細數據檢視中顯示的資訊。 您在 [詳細數據] 檢視中看到的數據行編號、標題和資訊,與 IShellFolder2::GetDetailsOf 的數據行相同。 請注意,可用的資訊欄位及其數據行編號會根據特定資料夾而有所不同。 您可以呼叫這個方法,並將 pidl 設定為 NULL,並檢查與每個數據行索引相關聯的標題,以列舉可用的欄位。 請記住,這些標題可以當地語系化,而且並非所有地區設定都相同。

檔系統資料夾有一組大型的標準資訊欄位。 前四個字位是所有文件系統資料夾的標準欄位。

Column index 欄標題
0 名稱
1 大小
2 類型
3 修改日期
 

檔案系統資料夾可以支援一些額外的欄位。 不過,不需要這麼做,而且指派給這些欄位的數據行索引可能會有所不同。

每個虛擬資料夾都有自己的唯一資訊欄位集。 一般而言,項目的顯示名稱位於數據行零,但其餘欄位的順序和內容取決於特定資料夾物件的實作。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
Dll Shell32.dll (5.0 版或更新版本)