parseURL Method
Parses an XML document from a system identifier (URI).
Note If you are using Microsoft® Internet Explorer 5.5, 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 5.5, Service Pack 1.
The parseURL
method is a shortcut 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.
Usage Syntax
oSAXXMLReader.parseURL(strURL)
Parameters
- strURL
- The URL to load.
Remarks
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 ErrorHandler
. The ErrorHandler
always returns the internal error code to the parseURL
method, even if the ErrorHandler
raises a user-defined error.
The base URL and secure base URL can be set by the putBaseURL
and putSecureBaseURL
methods. These methods are shortcuts for reading a document from a system identifier.
Syntax
HRESULT ParseURL( [in] const wchar_t * pwchUrl);
Parameters
- pwchUrl [in]
- The URL (zero-terminated Unicode string) to load from.
Return Values
- S_OK
- The value returned if parsing is successful.
- Other
- Either the parser error code or the code returned by the custom
ErrorHandler
. Unresolved URLs, security, and network errors are returned in the same way.
Remarks
During 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 ISAXErrorHandler : IUnknown
interface. If the ErrorHandler
returns anything but S_OK, parsing is aborted and the parseURL
method returns the internal error that stopped the parser. The ErrorHandler
always returns the internal error code, even if the ErrorHandler
returns a user-defined HRESULT to the parseURL
method. 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.
To view reference information for Visual Basic or C/C++ only, click the Language Filter button in the upper-left corner of the page.
See Also
baseURL Property (Visual Basic) | ISAXErrorHandler Interface | parse Method | putBaseURL Method (C/C++) | putSecureBaseURL Method (C/C++) | secureBaseURL Property (Visual Basic)
Applies to: ISAXXMLReader Interface