Instructs the object to initialize itself using the properties available in the property bag, notifying the provided error log object when errors occur. All property storage must take place within this method call as the object cannot hold the IPropertyBag pointer.
HRESULT Load(
IPropertyBag *
pPropBag, // Points to callerÆs property bag
IErrorLog *pErrorLog // Points to error log
);
Parameters
pPropBag
[in] A pointer to the callerÆs property bag through which the object can read properties. Cannot be NULL.
pErrorLog
[in] A pointer to the callerÆs error log in which the object stores any errors that occur during initialization. Can be NULL in which case the caller is not interested in errors.
Return Values
S_OK
The object successfully initialized itself.
E_UNEXPECTED
This method was called after IPersistPropertyBag::InitNew has already been called. They two initialization methods are mutually exclusive.
E_POINTER
The address in pPropBag is not valid (such as NULL) and therefore the object cannot initialize itself.
E_FAIL
The object was unable to retrieve a critical property that is necessary for the objectÆs successful operation. The object was therefore unable to initialize itself completely.
Remarks
E_NOTIMPL is not a valid return code as any object implementing this interface must support the entire functionality of the interface.
See Also