ShellUIHelper.AddChannel-Methode

Fügt der Liste der Kanäle im Windows Internet Explorer Favoritenmenü und der Kanalleiste auf dem Desktop einen neuen Kanal hinzu.

Hinweis

Diese Methode wird unter Windows Vista nicht mehr unterstützt. Unter diesem Betriebssystem wird E_NOTIMPL zurückgegeben.

 

Syntax

iRetVal = ShellUIHelper.AddChannel(
  sURL
)

Parameter

sURL [in]

Typ: BSTR

Ein String-Wert , der die URL der CDF-Datei angibt.

Hinweis

Die Links in der CDF-Datei müssen HTTP-, HTTPS- oder FTP-Protokolle verwenden. Wenn die CDF-Datei ein anderes Protokoll enthält, schlägt das Hinzufügen des Kanals fehl, und es wird kein Dialogfeld angezeigt.

 

Beispiele

Das folgende Beispiel zeigt die ordnungsgemäße Verwendung dieser Methode für JScript, die in HTML und Visual Basic eingebettet ist.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Exdisp.h
DLL
Shell32.dll (Version 4.71 oder höher)