IPersistPropertyBag::Load


		Contents Index Topic Contents
	Previous Topic: IPersistPropertyBag::InitNew Next Topic: IPersistPropertyBag::Save

IPersistPropertyBag::Load
HRESULT Load([in] IPropertyBag *pPropBag, 
		[in] IErrorLog *pErrorLog);
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 loading must take place within this function call because the object cannot hold the IPropertyBag pointer.

Returns:

S_OK The object successfully initialized itself.
E_UNEXPECTED This member 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.

pPropBag
[in] Address of the caller's property bag through which the object can read properties. Cannot be NULL.
pErrorLog
[in] Address of the caller's error log in which the object stores any errors that occur during initialization. Can be NULL; in that case, the caller is not interested in errors.

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

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

S_OK	The object successfully initialized itself.
E_UNEXPECTED	This member 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.