Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 IMonikerinterface that references persistent state for the object to be loaded.

pibc

[in] Address of the IBindCtxinterface 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 STGMenumeration, which indicates the access mode to use when binding to the persistent state. The IPersistMoniker::Loadmethod can treat this value as a suggestion, adding more restrictive permissions if necessary. If grfModeis 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::BindToStoragemethod, requesting either the IStreamor IStorageinterface.

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later