IPersistMoniker::Load


		Contents Index Topic Contents
	Previous Topic: IPersistMoniker::IsDirty Next Topic: IPersistMoniker::Save

IPersistMoniker::Load
HRESULT Load(
    [in] BOOL fFullyAvailable,
    [in] IMoniker *pmkSrc,
    [in] IBindCtx *pbc,
    [in] DWORD grfMode
);
Loads the object from its persistent state indicated by a supplied moniker.
Returns S_OK if the object was successfully loaded, or E_INVALIDARG if one or more parameters are invalid.

fFullyAvailable
If TRUE, the data referred to by the moniker has already been loaded once, and subsequent binding to the moniker should be synchronous. If FALSE, an asynchronous bind operation should be launched.
pmkSrc
Address of a moniker that references the persistent state for the object to be loaded.
pbc
Address of the IBindCtx interface for the bind context to be used for any moniker binding during this method.
grfMode
Combination of values from the STGM enumeration, which indicates the access mode to use when binding to the persistent state. The IPersistMoniker::Load method can treat this value as a suggestion, adding more restrictive permissions if necessary. If grfMode is zero, the implementation should bind to the persistent state using default permissions.

Typically, the object will immediately bind to its persistent state through a call to the source moniker's IMoniker::BindToStorage method, requesting either the IStream or IStorage interface.
See also IPersistMoniker::Save, IPersistMoniker::SaveCompleted

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