AddToFavoritesBar method
Deprecated. Adds a URL to the Favorites Bar.
.png){kind=icon} |
Syntax
*object.*AddToFavoritesBar(URL, Title, Type)
Parameters
URL [in]
Type: BSTR
The URL of the page to add.
Title [in]
Type: BSTR
The Title for this page.
Type [in, optional]
Type: VARIANT
Variant of type String that specifies one of the following, or null.
feed
The content is a RSS feed.
slice
The content is a Web Slice.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Standards information
There are no standards that apply here.
Remarks
As of Internet Explorer 10, this method is deprecated and should no longer be used. In addition, this method is not supported for Windows Store apps using JavaScript and will fail silently if called.
Caller must specify a non-null, non-empty URL and Title, and can optionally identify the URL as an RSS feed or a Web Slice. If the Type is a feed or slice, the function will subscribe using the Windows RSS Platform. When subscribing to a feed or a Web Slice, the Title is only used until the data can be retrieved from the server.
If no Type is specified, the item is simply added as a bookmark to the Favorites Bar.
Windows Internet Explorer 8 and later. For security reasons, the AddToFavoritesBar method must be called as a response to a user-initiated action, such a mouse click. If called from a different context, such as the onload event of the body element, the AddToFavoritesBar method fails silently.