Partager via

Méthode ShellUIHelper.AddChannel

  • Article

Ajoute un nouveau canal à la liste des canaux dans le menu Favoris windows Internet Explorer et à la barre canal sur le bureau.

Notes

Cette méthode n’est plus prise en charge sous Windows Vista. Sous ce système d’exploitation, il retourne E_NOTIMPL.

 

Syntaxe

iRetVal = ShellUIHelper.AddChannel(
  sURL
)

Paramètres

sURL [in]

Type : BSTR

Valeur string qui spécifie l’URL du fichier CDF.

Notes

Les liens dans le fichier CDF doivent utiliser des protocoles HTTP, HTTPS ou FTP. Si le fichier CDF contient un autre protocole, l’ajout du canal échoue et aucune boîte de dialogue n’apparaît.

 

Exemples

L’exemple suivant montre l’utilisation correcte de cette méthode pour JScript incorporé dans HTML et 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

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
En-tête
Exdisp.h
DLL
Shell32.dll (version 4.71 ou ultérieure)