Compartir a través de

Método ShellUIHelper.AddChannel

  • Artículo

Agrega un nuevo canal a la lista de canales del menú Favoritos de Windows Internet Explorer y a la barra de canales del escritorio.

Nota

Este método ya no se admite en Windows Vista. En ese sistema operativo, devuelve E_NOTIMPL.

 

Sintaxis

iRetVal = ShellUIHelper.AddChannel(
  sURL
)

Parámetros

sURL [in]

Tipo: BSTR

Valor de tipo String que especifica la dirección URL del archivo CDF.

Nota

Los vínculos del archivo CDF deben usar protocolos HTTP, HTTPS o FTP. Si el archivo CDF contiene cualquier otro protocolo, se produce un error en la adición del canal y no aparece ningún cuadro de diálogo.

 

Ejemplos

En el ejemplo siguiente se muestra el uso adecuado de este método para JScript incrustado en HTML y Visual Basic.

Jscript:

<html>
<head>
<title></title>

<object id="ShellUIHelper"
        classid="CLSID:64AB4BB7-111E-11d1-8F79-00C04FC2FBE1"
        width=0
        height=0
        VIEWASTEXT>
</object>

<script language="JavaScript">
    function fnShellUIHelperAddChannelJ()
    {
        ShellUIHelper.AddChannel("https://www.microsoft.com/windows/cdf/g_stock.cdf");
    }
</script>

</head>
<body onload=fnShellUIHelperAddChannelJ()>
</body>
</html>

Visual Basic:

Private Sub fnShellUIHelperAddChannelVB()
    Dim objShellUIHelper As ShellUIHelper
    
    Set objShellUIHelper = New ShellUIHelper
        objShellUIHelper.AddChannel ("https://www.microsoft.com/windows/cdf/g_stock.cdf")
    Set objShellUIHelper = Nothing
End Sub

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Exdisp.h
Archivo DLL
Shell32.dll (versión 4.71 o posterior)