IPersistMoniker::Load

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.