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.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in urlmon.h.

See Also

IPersistMoniker::Save, IPersistMoniker::SaveCompleted