Método IResolveShellLink::ResolveShellLink (shobjidl_core.h)

Solicita que um objeto de pasta resolve um link do Shell.

Sintaxe

HRESULT ResolveShellLink(
  [in] IUnknown *punkLink,
  [in] HWND     hwnd,
  [in] DWORD    fFlags
);

Parâmetros

[in] punkLink

Tipo: IUnknown*

Ponteiro para a interface IShellLink do objeto. Essa interface pode ser consultada para determinar o conteúdo do link.

[in] hwnd

Digite: HWND

Manipule para a janela que o Shell usa como pai para uma caixa de diálogo. O Shell exibirá a caixa de diálogo se precisar solicitar mais informações ao usuário ao resolver o link.

[in] fFlags

Tipo: DWORD

Sinalizadores de ação. Esse parâmetro pode ser uma combinação dos seguintes valores.

SLR_INVOKE_MSI

Chame o Windows Installer.

SLR_NOLINKINFO

Desabilitar o acompanhamento de link distribuído. Por padrão, o rastreamento de link distribuído rastreia a mídia removível em vários dispositivos com base no nome do volume. Ele também usa o caminho UNC para rastrear sistemas de arquivos remotos cuja letra da unidade foi alterada. Definir SLR_NOLINKINFO desabilita os dois tipos de acompanhamento.

SLR_NO_UI

Não exiba uma caixa de diálogo se o link não puder ser resolvido. Quando SLR_NO_UI é definido, a palavra de alta ordem fFlags especifica uma duração de tempo limite, em milissegundos. A função retornará se o link não puder ser resolvido dentro da duração do tempo limite. Se a palavra de alta ordem for definida como zero, a duração do tempo limite será padrão para 3000 milissegundos (3 segundos).

SLR_NOUPDATE

Não atualize as informações do link.

SLR_NOSEARCH

Não execute a heurística de pesquisa.

SLR_NOTRACK

Não use o acompanhamento de link distribuído.

SLR_UPDATE

Se o objeto de link tiver sido alterado, atualize o caminho e a lista de identificadores. Se SLR_UPDATE estiver definido, você não precisará chamar IPersistFile::IsDirty para determinar se o objeto de link foi alterado.

Valor retornado

Tipo: HRESULT

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

Comentários

Esse método deve tentar localizar o destino de um link do Shell, mesmo que o destino tenha sido movido ou renomeado.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

IResolveShellLink