Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IPersistPropertyBag::Load Method

Instructs the object to initialize itself using the properties available in the property bag, and to notify the provided error log object when errors occur.

Syntax


HRESULT Load(
    IPropertyBag *pPropBag,
    IErrorLog *pErrorLog
);

Parameters

pPropBag
[in] The address of the caller's property bag, through which the object can read properties. This cannot be NULL.
pErrorLog
[in] The address of the caller's error log, in which the object stores any errors that occur during initialization. This can be NULL; in which case, the caller does not receive errors.

Return Value

Returns one of the following values.

S_OK The object successfully initialized itself.
E_UNEXPECTED This member was called after IPersistPropertyBag::InitNew was called. The two initialization methods are mutually exclusive.
E_POINTER The address in pPropBag is not valid (such as NULL), and the object cannot initialize itself.
E_FAIL The object was unable to retrieve a property that is necessary for the object's successful operation. The object was unable to initialize itself completely.

Remarks

All property loading must take place in the IPersistPropertyBag::Load function call, because the object cannot hold the IPropertyBag pointer.

E_NOTIMPL is not a valid return code, because any object that implements this interface must support the entire functionality of the interface.

Community Additions

Show:
© 2014 Microsoft