IXMLParser::Load

4/8/2010

This method provides XML input to the parser.

Syntax

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

Parameters

• fFullyAvailable
  [in] Boolean value that indicates whether the node is fully available.

• pimkName
  [in] Pointer to the moniker name.

• pibc
  [in] Pointer to the bind context.

• grfMode
  [in] Flags that should be used when opening the file that contains the object identified by the moniker. The values for these flags are taken from the STGM enumeration and are as follows.

  Group	Flag	Value
  Access	STGM_READ	0x00000000L
  	STGM_WRITE	0x00000001L
  	STGM_READWRITE	0x00000002L
  Sharing	STGM_SHARE_DENY_NONE	0x00000040L
  	STGM_SHARE_DENY_READ	0x00000030L
  	STGM_SHARE_DENY_WRITE	0x00000020L
  	STGM_SHARE_EXCLUSIVE	0x00000010L
  	STGM_PRIORITY	0x00040000L
  Creation	STGM_CREATE	0x00001000L
  	STGM_CONVERT	0x00020000L
  	STGM_FAILIFTHERE	0x00000000L
  Transactioning	STGM_DIRECT	0x00000000L
  	STGM_TRANSACTED	0x00010000L
  Transactioning Performance	STGM_NOSCRATCH	0x00100000L
  	STGM_NOSNAPSHOT	0x00200000L
  Direct SWMR and Simple	STGM_SIMPLE	0x08000000L
  	STGM_DIRECT_SWMR	0x00400000L
  Delete On Release	STGM_DELETEONRELEASE	0x04000000L

Return Value

This function returns S_OK if the function is successful, otherwise an error code is returned.

Remarks

This method corresponds to IPersistMoniker::Load. The parser will call IMoniker::BindToStorage to get an IStream and load the XML associated with the given moniker. The IXMLNodeSource::GetURL method can also be called to get the URL representation of the given moniker. This method will not work on a moniker created by using the CreateFileMoniker function; instead, use the CreateURLMoniker function to create the moniker.

Requirements

See Also

Reference

IXMLParser
IXMLNodeSource::GetURL