IPersistMoniker::Load

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method loads the object from its persistent state indicated by a supplied moniker.

Syntax

HRESULT Load(
  BOOL fFullyAvailable,
  IMoniker* pimkName,
  LPBC pibc,
  DWORD grfMode
);

Parameters

• fFullyAvailable
  [in] Boolean value that indicates if the data referred to by the moniker has been loaded once. If TRUE, the subsequent binding to the moniker should be synchronous. If FALSE, an asynchronous bind operation should be launched.

• pimkName
  [in] Address of the IMoniker interface that references persistent state for the object to be loaded.

• pibc
  [in] Address of the IBindCtx interface for the bind context to be used for any moniker binding during this method.

• grfMode
  [in] Unsigned long integer value that contains a 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.

Return Value

Returns S_OK if the object was successfully loaded or E_INVALIDARG if 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.

Requirements