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 parses an XML document from a system identifier (URI). The base URL and secure base URL can be set by the putBaseURLand putSecureBaseURLmethods. These methods are shortcuts for reading a document from a system identifier. If the system identifier is a URL, the application must fully resolve the URL before passing it to the reader.

Syntax 

HRESULT ParseURL(
  const wchar_t* 
pwchUrl
);

Parameters

pwchUrl

[in] Pointer to the URL (zero-terminated Unicode string) to load from.

Return Value

S_OK

Returned if parsing is successful.

Other

Returns either the parser error code or the code returned by the custom error handler. Unresolved URLs, security, and network errors are returned in the same way.

Remarks

If you are using Microsoft® Internet Explorer 5.5 for Windows Embedded CE Internet Browser, you may get an E_PENDING error when you attempt to load an XML file that has external entities. To correct this situation, upgrade to Internet Explorer for Windows Embedded CE Service Pack 1.

While parsing, the reader provides information about the XML document through the registered event handlers. If an error occurs during parsing, the reader calls the appropriate method of the ISAXErrorHandlerinterface. If the error handler returns anything but S_OK, parsing is aborted and the parseURLmethod returns the internal error that stopped the parser. Note that the error handler always returns the internal error code, even if the error handler returns a user-defined HRESULT to the parseURLmethod. The reader can return a number of return codes, including, but not limited to E_ACCESSDENIED, INET_E_OBJECT_NOT_FOUND, INET_E_DOWNLOAD_FAILURE, MSG_E_BADSTARTNAMECHAR, or MSG_E_MISSINGSEMICOLON.

Requirements

Header msxml2.h, msxml2.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also