IColumnProvider：：GetItemData 方法 (shlobj.h)

  • 發行項

要求指定檔案的數據行數據。

語法

HRESULT GetItemData(
  [in]  LPCSHCOLUMNID   pscid,
  [in]  LPCSHCOLUMNDATA pscd,
  [out] VARIANT         *pvarData
);

參數

[in] pscid

類型： LPCSHCOLUMNID

識別數據行的 SHCOLUMNID 結構。

[in] pscd

類型： LPCSHCOLUMNDATA

指定檔案的 SHCOLUMNDATA 結構。

[out] pvarData

類型： VARIANT*

VARIANT 的指標，其中包含屬於 pscid 所指定數據行之 pscd 所指定之檔案的數據。 如果檔案是數據行提供者所支援類別的成員，請設定此值。

傳回值

類型： HRESULT

如果傳回檔案數據，則傳回S_OK，S_FALSE數據行提供者不支援檔案，且不會傳回任何數據，否則傳回 COM 錯誤值。

備註

系統會呼叫這個方法，以擷取要顯示在指定數據行中之檔案的數據。 它應該是安全線程。

即使特定數據行提供者不支援其中許多檔案，還是會針對 Windows 檔案總管顯示的每個檔案呼叫此方法。 若要改善效能，請先檢查 pscd 所指向結構的 pwszExt 成員，以查看它是否有數據行提供者支援的擴展名。 如果沒有，請立即傳回S_FALSE，以避免不必要的處理。

規格需求

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