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) |