IItemPropertyBag：：Read 方法

導致從屬性包讀取一或多個屬性。 IItemPropertyBag介面僅在 Windows XP 和 Windows Server 2003 上受到支援，不應再使用。

語法

HRESULT Read(
  [in]  ULONG    cProperties,
  [in]  ITEMPROP *pPropBag,
  [out] VARIANT  *pvarValue,
  [out] HRESULT  *phrError
);

參數

cProperties [in]

要讀取的屬性數目。 這個引數會指定 pPropBag、 pvarValue和 phrError陣列中的元素數目。

pPropBag [in]

ITEMPROP結構的陣列指標，指定所要求的屬性。

pvarValue [out]

接收指標，這個指標會傳回接收屬性值的 VARIANT 結構陣列。

phrError [out]

HRESULT值陣列的指標，這個陣列會接收讀取每個屬性的結果。 此陣列中必須至少有 cProperties 元素。

傳回值

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

備註

IItemPropertyBag介面僅在 Windows XP 和 Windows Server 2003 上受到支援，不應再使用。

若要在執行 Windows XP 或 Windows Server 2003 的電腦上預覽具有協力廠商通訊協定處理常式的附件，您可能需要使用 IItemPropertyBag 介面和下列 API： ISearchProtocolUI、 IItemPreviewerExt 和 ISearchItem 介面、 LINKINFO 和 ITEMPROP 結構和 LINKTYPE 列舉。

規格需求

需求	值
最低支援的用戶端	具有 SP2 的 Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0

另請參閱

IItemPropertyBag