IShellUIHelper3::AddInPrivateSubscription Method
Note: This documentation is preliminary and is subject to change.
Subscribe to an InPrivate Blocking feed.
Syntax
HRESULT AddInPrivateSubscription( BSTR URL, BSTR bstrFilterName );
Parameters
- URL
[in] The URL of an Atom or Really Simple Syndication (RSS) feed. Note The URL parameter allows only https: and https: protocol schemes.- bstrFilterName
[in] The Web Filter title displayed in Manage Add-ons.
Return Value
Remarks
InPrivate Blocking subscriptions are active only in InPrivate Browsing sessions, and they do not block content while InPrivate Browsing is off. To start InPrivate Browsing, select InPrivate Browsing from the Safety menu in Internet Explorer. InPrivate Blocking compares third-party URLs (resources hosted in different domains) against the rules in the filter file, and either blocks or allows the navigation. Top-level navigations are unaffected.
The following RSS elements are required by the InPrivate Blocking subscription feed.
RSS "channel" sub-element Atom "feed" sub-element Description title title Title of the filter feed. link link URL of the filter author. description subtitle Description of what the filter does. Each feed item may contain zero, one, or both of the
at:allowRegex
andat:blockRegex
elements. These elements contain one or more CDATAs, which contain exactly one regular expression. Characters in the URL that have special meaning to the regular expression, such as dots ('.') and path separators ('/'), must be escaped with a backslash ('\').
RSS "item" sub-element Atom "entry" sub-element Description description summary Body of the feed item. wf:allowRegex wf:allowRegex Defines an "allow" expression. wf:blockRegex wf:blockRegex Defines a "block" (deny) expression. Multiple items are allowed in the filter feed. All
at:allowRegex
elements are merged into a single "allow" expression for the web filter. Similarly, allat:blockRegex
elements are merged into a single "block" expression. These regular expressions allow or block third-party URLs that match the specified patterns.