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.




  • URL [in]
    Type: BSTR

    A String that specifies the URL of a CDF file to be installed.

    Note The links in the CDF file must use HTTP, HTTPS, or FTP. If the CDF file contains any other protocol, the addition of the channel will fail, and no dialog box will appear.

Return value


If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Standards information

There are no standards that apply here.


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).


This example uses the AddChannel method to display a dialog box that enables the user to add the channel described in the specified CDF file.


See also



Introduction to Active Channel Technology