Metodo ShellUIHelper.AddChannel

Articolo
06/13/2023

Aggiunge un nuovo canale all'elenco di canali nel menu Preferiti di Windows Internet Explorer e alla barra del canale sul desktop.

Nota

Questo metodo non è più supportato in Windows Vista. In tale sistema operativo, restituisce E_NOTIMPL.

Sintassi

iRetVal = ShellUIHelper.AddChannel(
  sURL
)

Parametri

sURL [in]

Tipo: BSTR

Valore String che specifica l'URL del file CDF.

Nota

I collegamenti nel file CDF devono usare protocolli HTTP, HTTPS o FTP. Se il file CDF contiene qualsiasi altro protocollo, l'aggiunta del canale non riesce e non viene visualizzata alcuna finestra di dialogo.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo appropriato di questo metodo per JScript incorporato in HTML e 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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Exdisp.h
DLL	Shell32.dll (versione 4.71 o successiva)

Condividi tramite