Compartilhar via


Método IItemPreviewerExt::SuggestBrowserPolicy

Sugere a política de segurança a ser aplicada ao navegador.

Sintaxe

HRESULT SuggestBrowserPolicy(
  [in]          DWORD dwContext,
  [out, retval] DWORD *pdwFlags
);

Parâmetros

dwContext [in]

Tipo: DWORD

O identificador de contexto da operação. Substitua o padrão dwContext para definir um valor de sua escolha para o identificador de contexto.

pdwFlags [out, retval]

Tipo: DWORD*

Um ponteiro para um valor DWORD que contém sinalizadores de marcar de verificação. O sinalizador BROWSERPOLICY_UNTRUSTED_CONTENT desabilita qualquer possibilidade de a versão prévia ser capaz de executar script ou ActiveX. O parâmetro pdwFlags não deve ser um ponteiro NULL .

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

A interface IItemPreviewerExt tem suporte apenas no Windows XP e no Windows Server 2003 e não deve mais ser usada.

Para visualizar anexos com um manipulador de protocolo de terceiros em computadores que executam o Windows XP ou o Windows Server 2003, talvez seja necessário usar a interface IItemPreviewerExt e as seguintes APIs: as interfaces ISearchProtocolUI, IItemPropertyBag e ISearchItem , a estrutura LINKINFO e a enumeração LINKTYPE .

É altamente recomendável usar o sinalizador BROWSERPOLICY_UNTRUSTED_CONTENT para desabilitar qualquer possibilidade de a versão prévia ser capaz de executar script ou ActiveX. O método IItemPreviewerExt::SuggestBrowserPolicy pode retornar informações sobre se o item que está sendo visualizado é confiável ou não. Isso permitirá que o controle tridente do visualizador execute o script e até mesmo os controles ActiveX. Como o visualizador geralmente usa arquivos temporários para gerar a visualização, isso pode resultar em script inesperado e execução de código na zona Computador Local.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Redistribuível
Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

IItemPreviewerExt