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.

Syntax

object.AddChannel(URL)

Parameters

  • 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

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

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

Examples

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.

window.external.AddChannel("http://domain/folder/file.cdf");

See also

external

window

Introduction to Active Channel Technology