# IPersistMoniker::Load

Loads the object from its persistent state indicated by a supplied moniker.

HRESULT Load(

BOOL fFullyAvailable, | //Indicates whether the object was already loaded
IMoniker *pmkSrc, | //Pointer to source moniker that references the persistent state to be loaded
IBindCtx *pbc, | //Pointer to the moniker’s bind context
DWORD grfMode | //Access mode values taken from the STGM enumeration
); |

Parameters

fFullyAvailable
  [in] If TRUE, then the data referred to by the moniker has already been loaded once, and subsequent binding to the moniker should be synchronous. If FALSE, then an asynchronous bind operation should be launched.
pmkSrc
  [in] Pointer to a moniker that references the persistent state for the object to be loaded.
pbc
  [in] Pointer to the IBindCtx interface for the bind context to be used for any moniker binding during this method.
grfMode
  [in] A combination of values from the STGM enumeration which indicate 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.

Return Values

S_OK
  The object was successfully loaded.
E_INVALIDARG
  One or more parameters are invalid.

Remarks

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