IShellFolder2：：GetDefaultColumn 方法 (shobjidl_core.h)

取得預設排序和顯示數據行。

語法

HRESULT GetDefaultColumn(
  [in]  DWORD dwRes,
  [out] ULONG *pSort,
  [out] ULONG *pDisplay
);

參數

[in] dwRes

類型： DWORD

保留的。 設定為零。

[out] pSort

類型： ULONG*

值的指標，可接收預設排序數據行的索引。

[out] pDisplay

類型： ULONG*

值的指標，可接收預設顯示數據行的索引。

傳回值

類型： HRESULT

如果成功，則傳回S_OK，否則傳回 COM 錯誤值。

備註

使用者附註

這個方法傳回的這兩個數據行索引都供呈現此資料夾之資料夾檢視的應用程式使用。

pSort 指定的數據行是應該用來排序資料夾中項目的數據行。 若要判斷任何一對專案的排序順序，請將其 PID 傳遞給 CompareID。 將 CompareID 的 lParam 參數設定為 pSort 所指向的值，以指定數據行。

如果檢視只會顯示一個字串來代表專案，則應該取自 pDisplay 所指定的數據行。 將數據行索引和專案的 PIDL 傳遞至 IShellFolder2：：GetDetailsOf 以擷取字串。

實作者的注意事項

此方法是命名空間延伸模組資料夾物件實作的一部分。 通常由資料夾檢視物件呼叫，要求資料夾物件應該使用哪個數據行在 Microsoft Windows 檔案總管詳細資料檢視中排序資料夾中的專案。 例如，代表事務歷史記錄的資料夾物件可能會將 pSort 設定為顯示交易時間的數據行。 項目接著會依交易發生的時間排序，而不是依名稱排序。

有些用戶端可能會呼叫這個方法，以要求數據行的索引，其名稱應該顯示在樹視圖中。 將 pDisplay 設定為適當的數據行索引。 然後，用戶端會呼叫 IShellFolder2：：GetDetailsOf 來取得顯示名稱。

規格需求

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