Raccourcis Internet
L’objet de raccourci Internet est utilisé pour créer des raccourcis de bureau vers des sites Internet. À l’instar des raccourcis vers des éléments du système de fichiers, les raccourcis Internet prennent la forme d’une icône sur le bureau. Lorsque l’utilisateur clique sur l’icône, le navigateur est lancé et affiche le site associé au raccourci.
Les sujets suivants sont abordés.
Création de raccourcis Internet
Vous pouvez créer un raccourci Internet à l’aide d’un contrôle WebBrowser ou avec l’URL de la page.
Création d’un raccourci Internet à partir d’un contrôle WebBrowser
Si votre application héberge un contrôle WebBrowser, vous pouvez utiliser l’objet de raccourci Internet pour créer des raccourcis de la manière suivante.
- Créez une instance de l’objet de raccourci Internet avec CoCreateInstance, à l’aide d’un identificateur de classe (CLSID) de CLSID_InternetShortcut.
- Passez le pointeur vers l’interface IUnknown de WebBrowser à l’objet de raccourci Internet avec IObjectWithSite::SetSite.
- Appelez la méthode IPersistFile::Save de l’objet de raccourci Internet lorsque vous souhaitez créer un raccourci vers la page consultée par le contrôle WebBrowser.
Un raccourci est créé à l’emplacement spécifié dans IPersistFile::Save. Cet emplacement permet au contrôle WebBrowser de restaurer son état, ce qui inclut la tâche de charger les documents appropriés dans des jeux de cadres.
Création d’un raccourci Internet à partir d’une URL
Vous pouvez également créer un raccourci Internet si vous avez l’URL de la page vers laquelle vous souhaitez lier.
- Créez une instance de l’objet de raccourci Internet avec CoCreateInstance, à l’aide d’un CLSID de CLSID_InternetShortcut.
- Utilisez la méthode IUniformResourceLocator::SetURL pour définir l’URL dans le raccourci.
- Utilisez la méthode IPersistFile::Save pour enregistrer le fichier de raccourcis à l’emplacement souhaité.
Accès au stockage de propriétés
L’objet de raccourci Internet contient plusieurs propriétés auxquelles vous pouvez accéder via l’interface IPropertySetStorage de l’objet avec la procédure suivante.
- Obtenez l’interface IPropertySetStorage en appelant QueryInterface avec IID_IPropertySetStorage.
- Accédez au jeu de stockage de la propriété de raccourci Internet en appelant IPropertySetStorage::Open avec FMTID_Intshcut ou FMTID_InternetSite pour obtenir l’interface IPropertyStorage .
- Lisez les informations de stockage de propriété avec IPropertyStorage::ReadMultiple en transmettant l’ID de propriété approprié.
Avec la version 4.70 ou ultérieure de Shell32.dll, vous pouvez également récupérer l’interface IPropertySetStorage en appelant IShellFolder::BindToStorage avec le paramètre pidl défini sur . Fichier d’URL et paramètre riid défini sur IID_IPropertySetStorage.
Les ID de propriété suivants peuvent être demandés pour FMTID_Intshcut.
| PROPID | Type de variante | Description |
|---|---|---|
| PID_IS_URL | VT_LPWSTR | URL vers laquelle mène le raccourci |
| PID_IS_NAME | VT_LPWSTR | Nom du raccourci Internet |
| PID_IS_WORKINGDIR | VT_LPWSTR | Répertoire de travail pour le raccourci |
| PID_IS_HOTKEY | VT_UI2 | Touche d’accès rapide pour le raccourci |
| PID_IS_SHOWCMD | VT_I4 | Afficher la commande pour le raccourci |
| PID_IS_ICONINDEX | VT_I4 | Index de l’icône |
| PID_IS_ICONFILE | VT_LPWSTR | Fichier contenant l’icône |
| PID_IS_WHATSNEW | VT_LPWSTR | Texte Nouveautés |
| PID_IS_AUTHOR | VT_LPWSTR | Auteur |
| PID_IS_DESCRIPTION | VT_LPWSTR | Texte de description du site |
| PID_IS_COMMENT | VT_LPWSTR | Commentaire annoté par l’utilisateur |
| PID_IS_ROAMED | VT_BOOL | True lorsque le raccourci est itinérant pour la première fois |
Les ID de propriété suivants peuvent être demandés pour FMTID_InternetSite.
| PROPID | Type de variante | Description |
|---|---|---|
| PID_INTSITE_WHATSNEW | VT_LPWSTR | Texte Nouveautés |
| PID_INTSITE_AUTHOR | VT_LPWSTR | Auteur |
| PID_INTSITE_LASTVISIT | VT_FILETIME | Heure de la dernière visite du site |
| PID_INTSITE_LASTMOD | VT_FILETIME | Heure de la dernière modification du site |
| PID_INTSITE_VISITCOUNT | VT_UI4 | Nombre de fois que l’utilisateur a visité |
| PID_INTSITE_DESCRIPTION | VT_LPWSTR | Texte de description du site |
| PID_INTSITE_COMMENT | VT_LPWSTR | Commentaire annoté par l’utilisateur |
| PID_INTSITE_FLAGS | VT_UI4 | Indique l’utilisation d’indicateurs PIDISF_ (voir ci-dessous) |
| PID_INTSITE_CONTENTLEN | N/A | Non prise en charge pour le moment |
| PID_INTSITE_CONTENTCODE | N/A | Non prise en charge pour le moment |
| PID_INTSITE_RECURSE | N/A | Non prise en charge pour le moment |
| PID_INTSITE_WATCH | N/A | Non prise en charge pour le moment |
| PID_INTSITE_SUBSCRIPTION | VT_UI8 | Valeur SUBSCRIPTIONCOOKIE pour le gestionnaire d’abonnements |
| PID_INTSITE_URL | VT_LPWSTR | URL vers laquelle mène le raccourci |
| PID_INTSITE_TITLE | VT_LPWSTR | Titre |
| PID_INTSITE_CODEPAGE | VT_UI4 | Page de code du document |
| PID_INTSITE_TRACKING | N/A | Non prise en charge pour le moment |
| PID_INTSITE_ICONINDEX | VT_I4 | Index de l’icône |
| PID_INTSITE_ICONFILE | VT_LPWSTR | Fichier contenant l’icône |
| PID_INTSITE_ROAMED | VT_UI4 | L’entrée a été ajoutée en raison de l’itinérance |
Voici les indicateurs de site Internet.
| Indicateur | Description |
|---|---|
| PIDISF_RECENTLYCHANGED | Indique qu’un site a été récemment modifié |
| PIDISF_CACHEDSTICKY | Non prise en charge pour le moment |
| PIDISF_CACHEIMAGES | Non prise en charge pour le moment |
| PIDISF_FOLLOWALLLINKS | Non prise en charge pour le moment |
Les valeurs suivantes sont utilisées pour l’historique de l’itinérance Internet.
| Valeur de PID_INTSITE_ROAMED | Description |
|---|---|
| Valeur non définie ou PIDISR_UP_TO_DATE | Cette entrée de cache n’a pas été modifiée par l’itinérance. |
| PIDISR_NEEDS_ADD | Cette entrée de cache a été ajoutée au cache par itinérance. Définissez PIDISR_UP_TO_DATE une fois le traitement de l’entrée terminé. |
| PIDISR_NEEDS_UPDATE | Cette entrée de cache existait déjà sur l’ordinateur local, mais elle a été mise à jour par itinérance. Définissez PIDISR_UP_TO_DATE une fois le traitement de l’entrée terminé. |
| PIDISR_NEEDS_DELETE | L’itinérance a détecté que cette entrée de cache doit être supprimée. Par exemple, l’utilisateur peut avoir effacé son historique de navigateur. Supprimez l’entrée à l’aide de DeleteUrlCacheEntry. |
Interfaces
L’objet de raccourci Internet expose un certain nombre d’interfaces.
interfaces OLE
Interfaces shell
Fonctions
Il existe plusieurs fonctions utilitaires qui peuvent être utilisées avec l’objet de raccourci Internet.
Fonctions de l’utilitaire de raccourci Internet