Compartilhar via

Método ShellUIHelper.AddChannel

  • Artigo

Adiciona um novo canal à lista de canais no menu Favoritos da Internet do Windows Explorer e à barra Canal na área de trabalho.

Observação

Não há mais suporte para esse método no Windows Vista. Nesse sistema operacional, ele retorna E_NOTIMPL.

 

Sintaxe

iRetVal = ShellUIHelper.AddChannel(
  sURL
)

Parâmetros

sURL [in]

Tipo: BSTR

Um valor String que especifica a URL do arquivo CDF.

Observação

Os links no arquivo CDF devem usar protocolos HTTP, HTTPS ou FTP. Se o arquivo CDF contiver qualquer outro protocolo, a adição do canal falhará e nenhuma caixa de diálogo será exibida.

 

Exemplos

O exemplo a seguir mostra o uso adequado desse método para JScript inserido em 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

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Exdisp.h
DLL
Shell32.dll (versão 4.71 ou posterior)