IShellUIHelper::AddChannel Method

Obsolete. Presents a dialog box that enables the user to add the specified channel, or to change the channel URL, if it is already installed.


HRESULT AddChannel(


[in] A BSTR that specifies the URL of a Channel Definition Format (CDF) file to be installed.
Note  The links in the CDF file must use HTTP, Secure Hypertext Transfer Protocol (HTTPS), or File Transfer Protocol (FTP). If the CDF file contains any other protocol, the addition of the channel will fail, and no dialog box will appear.

Return Value

Returns S_OK if successful, or an error value otherwise.


In Windows Internet Explorer 7, the CDF is obsolete and should not be used.

If the call fails, an error dialog box appears. You can suppress the dialog box by using the onerror event.

Note  This method is intended for use by publishers shipping Microsoft Active Channel content. Active Channel technology is available as of Microsoft Internet Explorer 4.0 and later.

This method is not supported in HTML Applications (HTAs).

See Also

Introduction to Active Channel Technology