IPropertyBag：：Read 方法 (oaidl.h)

將具名屬性讀入呼叫端初始化的 VARIANT。

語法

HRESULT Read(
  LPCOLESTR pszPropName,
  VARIANT   *pVar,
  IErrorLog *pErrorLog
);

參數

pszPropName

要讀取之屬性名稱的位址。 這不可以是 NULL。

pVar

呼叫端初始化 VARIANT 的位址，該 VARIANT 會接收輸出上的屬性值。 函式會在傳回之前，先設定 VARIANT 中的類型欄位和值欄位。 如果呼叫端在 pVar->vt 專案上初始化欄位，屬性包會嘗試將其對應的值變更為此類型。 如果呼叫端將 設定 pVar->vt 為 VT_EMPTY，則屬性包可以使用任何方便的類型。

pErrorLog

呼叫端錯誤記錄檔的位址，其中屬性包會儲存讀取期間發生的任何錯誤。 這可以是 NULL;在此情況下，呼叫端不會收到錯誤。

傳回值

An HRESULT

備註

Read 方法會指示屬性包將 pszPropName 中名為 的屬性讀取到 pVar 中呼叫端初始化的 VARIANT。 錯誤會記錄在 pErrorLog 所指向的錯誤記錄檔中。 當指定另一個對象指標 (VT_UNKNOWN) 時 pVar->vt ，屬性包會負責建立和初始化 pszPropName 所描述的物件。

E_NOTIMPL不是有效的傳回碼，因為任何實作此介面的對象都必須支援介面的整個功能。

規格需求