IXMLParser::Load

Article
08/28/2006

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 Values

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

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: xmlparser.h

Share via