IPersistPropertyBagImpl 類別

這個類別會實作 IUnknown 物件，並允許物件將其屬性儲存至用戶端提供的屬性包。

重要

這個類別及其成員不能用於在 Windows 執行階段 中執行的應用程式。

語法

template <class T>
class ATL_NO_VTABLE IPersistPropertyBagImpl : public IPersistPropertyBag

參數

T
您的類別衍生自 IPersistPropertyBagImpl。

成員

公用方法

名稱	描述
IPersistPropertyBagImpl：：GetClassID	擷取物件的 CLSID。
IPersistPropertyBagImpl：：InitNew	初始化新建立的物件。 ATL 實作會傳回S_OK。
IPersistPropertyBagImpl：：Load	從用戶端提供的屬性包載入物件的屬性。
IPersistPropertyBagImpl：：Save	將物件的屬性儲存到用戶端提供的屬性包中。

備註

IPersistPropertyBag 介面可讓物件將其屬性儲存至用戶端提供的屬性包。 類別 IPersistPropertyBagImpl 提供這個介面的預設實作，並藉由將資訊傳送至偵錯組建中的傾印裝置來實 IUnknown 作。

IPersistPropertyBag會與 IPropertyBag 和 IErrorLog 搭配運作。 這兩個介面必須由客戶端實作。 透過 IPropertyBag，客戶端會儲存並載入物件的個別屬性。 透過 IErrorLog，物件和用戶端都可以報告發生的任何錯誤。

相關文章 ATL 教學課程：建立 ATL 專案

繼承階層架構

IPersistPropertyBag

IPersistPropertyBagImpl

需求

標頭： atlcom.h

IPersistPropertyBagImpl：：GetClassID

擷取物件的 CLSID。

STDMETHOD(GetClassID)(CLSID* pClassID);

備註

請參閱 Windows SDK 中的 IPersist：：GetClassID 。

IPersistPropertyBagImpl：：InitNew

初始化新建立的物件。

STDMETHOD(InitNew)();

傳回值

傳回S_OK。

備註

請參閱 Windows SDK 中的 IPersistPropertyBag：：InitNew 。

IPersistPropertyBagImpl：：Load

從用戶端提供的屬性包載入物件的屬性。

STDMETHOD(Load)(LPPROPERTYBAG pPropBag, LPERRORLOG pErrorLog);

備註

ATL 會使用 對象的屬性對應來擷取此資訊。

請參閱 Windows SDK 中的 IPersistPropertyBag：：Load 。

IPersistPropertyBagImpl：：Save

將物件的屬性儲存到用戶端提供的屬性包中。

STDMETHOD(Save)(
    LPPROPERTYBAG pPropBag,
    BOOL fClearDirty,
    BOOL fSaveAllProperties);

備註

ATL 會使用 對象的屬性對應來儲存此資訊。 根據預設，不論 fSaveAllProperties 的值為何，這個方法都會儲存所有屬性。

請參閱 Windows SDK 中的 IPersistPropertyBag：：Save 。

另請參閱

BEGIN_PROP_MAP
類別概觀