ISAXXMLReader::putSecureBaseURL Method (Windows CE 5.0)

Send Feedback

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.

HRESULT putSecureBaseURL (const wchar_t* pwchSecureBaseUrl);

Parameters

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

Return Values

  • 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

OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.
Link Library: Uuid.lib.

See Also

getSecureBaseURL Method | ISAXXMLReader:IUnknown Interface

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.