Compartir a través de

AddChannel method

  • Artículo

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.

This method is not supported for Windows apps using JavaScript.

Syntax

HRESULT retVal = object.AddChannel(URL);

Parameters

  • URL [in]
    Type: BSTR

    A BSTR 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 HTMLLinkElementEvents::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