ISAXXMLReader::putSecureBaseURL Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method sets the secure base URL for the document. If the secure base URL is not set, full access is allowed. The secure base URL cannot be set during parsing. The underlying run-time environment determines the response to the security violation.

Syntax

HRESULT putSecureBaseURL (
  const wchar_t* pwchSecureBaseUrl
);

Parameters

• pwchSecureBaseUrl
  [in] Pointer to the secure base URL (zero-terminated Unicode string).

Return Value

• S_OK
  Returned if the secure base URL is successfully set.

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

Remarks

By setting the secure base URL, the application requests security enforcement by the Microsoft® Internet Explorer security settings, which control behavior on the user's computer. This means that the user, not the application, controls Internet security settings.

To understand what the secure base URL is, consider this example. When a parser reads an XML file from the site "www.a.com", both the base URL and the secure base URL are the same. Now, consider that in the XML file there is an external reference to the site "www.b.com". When reading the externally referenced file, the base URL will be "www.b.com", while the secure base URL is still "www.a.com".

Security Note:
For security reasons, the secure base URL cannot be set with script within the context of Internet Explorer.

Requirements

See Also

Reference

ISAXXMLReader::getSecureBaseURL Method
ISAXXMLReader