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

Article
08/26/2023

Demande qu’un objet de dossier résolve un lien Shell.

Syntaxe

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

Paramètres

[in] punkLink

Type : IUnknown*

Pointeur vers l’interface IShellLink de l’objet. Cette interface peut ensuite être interrogée pour déterminer le contenu du lien.

[in] hwnd

Type : HWND

Gérez la fenêtre que l’interpréteur de commandes utilise comme parent pour une boîte de dialogue. L’interpréteur de commandes affiche la boîte de dialogue s’il doit inviter l’utilisateur à fournir plus d’informations lors de la résolution du lien.

[in] fFlags

Type : DWORD

Indicateurs d’action. Ce paramètre peut être une combinaison des valeurs suivantes.

SLR_INVOKE_MSI

Appelez Windows Installer.

SLR_NOLINKINFO

Désactivez le suivi des liens distribués. Par défaut, le suivi des liens distribués effectue le suivi des médias amovibles sur plusieurs appareils en fonction du nom du volume. Il utilise également le chemin UNC pour suivre les systèmes de fichiers distants dont la lettre de lecteur a changé. La définition SLR_NOLINKINFO désactive les deux types de suivi.

SLR_NO_UI

N’affichez pas de boîte de dialogue si le lien ne peut pas être résolu. Lorsque SLR_NO_UI est défini, le mot d’ordre supérieur de fFlags spécifie une durée d’expiration, en millisecondes. La fonction retourne si le lien ne peut pas être résolu dans la durée du délai d’attente. Si le mot d’ordre supérieur est défini sur zéro, la durée du délai d’attente est par défaut de 3 000 millisecondes (3 secondes).

SLR_NOUPDATE

Ne mettez pas à jour les informations du lien.

SLR_NOSEARCH

N’exécutez pas l’heuristique de recherche.

SLR_NOTRACK

N’utilisez pas le suivi de liens distribués.

SLR_UPDATE

Si l’objet link a changé, mettez à jour son chemin et sa liste d’identificateurs. Si SLR_UPDATE est défini, vous n’avez pas besoin d’appeler IPersistFile::IsDirty pour déterminer si l’objet link a changé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode doit tenter de trouver la cible d’un lien Shell, même si la cible a été déplacée ou renommée.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

IResolveShellLink

Partager via