IShellDetails：：GetDetailsOf 方法 (shlobj_core.h)

  • 發行項

取得Shell資料夾中項目的詳細資訊。

語法

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

參數

[in, optional] pidl

類型： PCUITEMID_CHILD

您要求資訊的專案的 PIDL。 如果此參數設定為 NULL，iColumn 所指定的資訊欄位標題將會在 pDetails 所指向的 SHELLDETAILS 結構中傳回。

iColumn

類型： UINT

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

[out] pDetails

類型： SHELLDETAILS*

具有詳細資訊之 SHELLDETAILS 結構的指標。

傳回值

類型： HRESULT

如果成功，則傳回S_OK。 如果 iColumn 超過資料夾支援的數據行數目，則傳回E_FAIL。 否則，傳回標準 COM 錯誤碼。

備註

這個方法已被Shell 5.0版和更新版本的IShellFolder2方法取代。

IShellDetails：：GetDetailsOf 方法可讓您存取 Shell 資料夾的 Windows 檔案總管詳細數據檢視中顯示的資訊。 您在 [詳細數據] 檢視中看到的數據行編號、數據行標題和項目資訊，與 IShellDetails：：GetDetailsOf 所傳回的數據行編號、數據行標題和專案資訊相同。

可用的資訊欄位及其數據行編號會根據特定資料夾而有所不同。 若要列舉可用的欄位，請呼叫 IShellDetails：：GetDetailsOf ，並將 pidl 設定為 NULL 以增加 iColumn 的值。 此方法提供與每個數據行索引相關聯的標題。 當 iColumn 超過資料夾支援的數據行數目時，IShellDetails：：GetDetailsOf 會傳回E_FAIL。 請記住，這些標題是可本地化的，而且並非所有地區設定都相同。

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

數據行索引 欄標題
0 名稱
1 大小
2 類型
3 修改日期
 

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

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

實作者注意事項

資料夾對象應該實作 IShellFolder2 ，而不是這個介面。

規格需求

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