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.