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 sets the base URL for the document. The base URL cannot be set during parsing.

Syntax 

HRESULT putBaseURL(
  const wchar_t* 
pwchBaseUrl
);

Parameters

pwchBaseUrl

[in] Pointer to the base URL (zero-terminated Unicode string) for the document.

Return Value

S_OK

Returned if the base URL is successfully set.

E_FAIL

Returned if the application tries to set the base URL during parsing.

Remarks

The base URL represents the URL of the current XML document. The reader uses this base URL to resolve relative links (either for those links related to the parseURLmethod or for external entities in an XML document). To resolve these links, the reader uses the base URL in much the same way that an Internet browser uses a Web page's URL to resolve relative links contained on that page.

The base URL may be a complete URL. However, the reader only uses that portion of the URL up to and including the final backslash when resolving links. For instance, a base URL for a document is "http://msdn.microsoft.com/xml/test.xml". The reader would then only use "http://msdn.microsoft.com/xml/" when resolving links.

Here is an example of how the reader uses the base URL to resolve links. The base URL for a document is "http://msdn.microsoft.com/xml/test.xml". In that document, there is a link for "mytest.xml". The reader would resolve this link as "http://msdn.microsoft.com/xml/mytest.xml".

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