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 and at: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, all at:blockRegex elements are merged into a single "block" expression. These regular expressions allow or block third-party URLs that match the specified patterns.