Internetgenvägar
Internetgenvägsobjektet används för att skapa genvägar till webbplatser. Precis som genvägar till objekt i filsystemet får Internetgenvägar formen av en ikon på skrivbordet. När användaren klickar på ikonen startas webbläsaren och den webbplats som är associerad med genvägen visas.
Följande avsnitt beskrivs.
Skapa internetgenvägar
Du kan skapa en internetgenväg med hjälp av en WebBrowser-kontroll eller med sidans URL.
Skapa en internetgenväg från en WebBrowser-kontroll
Om programmet är värd för en WebBrowser-kontroll kan du använda internetgenvägsobjektet för att skapa genvägar på följande sätt.
- Skapa en instans av internetgenvägsobjektet med CoCreateInstancemed hjälp av en klassidentifierare (CLSID) för CLSID_InternetShortcut.
- Skicka pekaren till WebBrowser-gränssnittet IUnknown till internetgenvägsobjektet med IObjectWithSite::SetSite.
- Anropa internetgenvägsobjektets IPersistFile::Spara-metod när du vill skapa en genväg till sidan som visas av WebBrowser-kontrollen.
En genväg skapas på den plats som anges i IPersistFile::Spara. Den här platsen gör det möjligt för WebBrowser-kontrollen att återställa sitt tillstånd, vilket inkluderar uppgiften att läsa in rätt dokument i ramuppsättningar.
Skapa en internetgenväg från en URL
Du kan också skapa en Genväg till Internet om du har URL:en till sidan som du vill länka till.
- Skapa en instans av internetgenvägsobjektet med CoCreateInstancemed hjälp av ett CLSID för CLSID_InternetShortcut.
- Använd metoden IUniformResourceLocator::SetURL för att ange URL:en i genvägen.
- Använd metoden IPersistFile::Save för att spara genvägsfilen på en önskad plats.
Åtkomst till egenskapslagring
Internetgenvägsobjektet innehåller flera egenskaper som du kan komma åt via objektets IPropertySetStorage- gränssnitt med följande procedur.
- Hämta gränssnittet IPropertySetStorage genom att anropa QueryInterface med IID_IPropertySetStorage.
- Få åtkomst till egenskapen Internetgenväg genom att anropa IPropertySetStorage::Öppna med FMTID_Intshcut eller FMTID_InternetSite för att hämta IPropertyStorage--gränssnittet.
- Läs informationen om egenskapslagring med IPropertyStorage::ReadMultiple genom att skicka lämpligt egenskaps-ID.
Med version 4.70 eller senare av Shell32.dllkan du också hämta gränssnittet IPropertySetStorage genom att anropa IShellFolder::BindToStorage med parametern pidl inställd på . URL-filen och parametern riid inställd på IID_IPropertySetStorage.
Följande egenskaps-ID kan begäras för FMTID_Intshcut.
| PROPID | Varianttyp | Beskrivning |
|---|---|---|
| PID_IS_URL | VT_LPWSTR | URL som genvägen leder till |
| PID_IS_NAME | VT_LPWSTR | Namnet på internetgenvägen |
| PID_IS_WORKINGDIR | VT_LPWSTR | Arbetskatalog för genvägen |
| PID_IS_HOTKEY | VT_UI2 | Snabbtangent för genvägen |
| PID_IS_SHOWCMD | VT_I4 | Visa kommando för genväg |
| PID_IS_ICONINDEX | VT_I4 | Index för ikonen |
| PID_IS_ICONFILE | VT_LPWSTR | Fil som innehåller ikonen |
| PID_IS_WHATSNEW | VT_LPWSTR | Nyheter |
| PID_IS_AUTHOR | VT_LPWSTR | Författare |
| PID_IS_DESCRIPTION | VT_LPWSTR | Beskrivningstext för webbplatsen |
| PID_IS_COMMENT | VT_LPWSTR | Kommentera kommenterad av användare |
| PID_IS_ROAMED | VT_BOOL | Sant när genvägen flyttas för första gången |
Följande egenskaps-ID:er kan begäras för FMTID_InternetSite.
| PROPID | Varianttyp | Beskrivning |
|---|---|---|
| PID_INTSITE_WHATSNEW | VT_LPWSTR | Nyheter |
| PID_INTSITE_AUTHOR | VT_LPWSTR | Författare |
| PID_INTSITE_LASTVISIT | VT_FILETIME | Tid då webbplatsen senast besöktes |
| PID_INTSITE_LASTMOD | VT_FILETIME | Tid då webbplatsen senast ändrades |
| PID_INTSITE_VISITCOUNT | VT_UI4 | Antal gånger som användaren har besökt |
| PID_INTSITE_DESCRIPTION | VT_LPWSTR | Beskrivningstext för webbplatsen |
| PID_INTSITE_COMMENT | VT_LPWSTR | Kommentera kommenterad av användare |
| PID_INTSITE_FLAGS | VT_UI4 | Anger användning av PIDISF_ flaggor (se nedan) |
| PID_INTSITE_CONTENTLEN | Ej tillämpligt | Stöds inte för närvarande |
| PID_INTSITE_CONTENTCODE | Ej tillämpligt | Stöds inte för närvarande |
| PID_INTSITE_RECURSE | Ej tillämpligt | Stöds inte för närvarande |
| PID_INTSITE_WATCH | Ej tillämpligt | Stöds inte för närvarande |
| PID_INTSITE_SUBSCRIPTION | VT_UI8 | SUBSCRIPTIONCOOKIE-värde för prenumerationshanteraren |
| PID_INTSITE_URL | VT_LPWSTR | URL som genvägen leder till |
| PID_INTSITE_TITLE | VT_LPWSTR | Titel |
| PID_INTSITE_CODEPAGE | VT_UI4 | Dokumentets kodsida |
| PID_INTSITE_TRACKING | Ej tillämpligt | Stöds inte för närvarande |
| PID_INTSITE_ICONINDEX | VT_I4 | Index för ikonen |
| PID_INTSITE_ICONFILE | VT_LPWSTR | Fil som innehåller ikonen |
| PID_INTSITE_ROAMED | VT_UI4 | Posten lades till på grund av roaming |
Följande är webbplatsflaggor.
| Flagga | Beskrivning |
|---|---|
| PIDISF_RECENTLYCHANGED | Anger att en webbplats nyligen har ändrats |
| PIDISF_CACHEDSTICKY | Stöds inte för närvarande |
| PIDISF_CACHEIMAGES | Stöds inte för närvarande |
| PIDISF_FOLLOWALLLINKS | Stöds inte för närvarande |
Följande värden används för internetroaminghistorik.
| Värdet för PID_INTSITE_ROAMED | Beskrivning |
|---|---|
| Värdet har inte angetts eller PIDISR_UP_TO_DATE | Den här cacheposten har inte ändrats av roaming. |
| PIDISR_NEEDS_ADD | Den här cacheposten lades till i cacheminnet genom roaming. Ange PIDISR_UP_TO_DATE när bearbetningen av posten är klar. |
| PIDISR_NEEDS_UPDATE | Den här cacheposten fanns redan på den lokala datorn, men den uppdaterades av roaming. Ange PIDISR_UP_TO_DATE när bearbetningen av posten är klar. |
| PIDISR_NEEDS_DELETE | Roaming upptäckte att den här cacheposten ska tas bort. Användaren kan till exempel ha rensat sin webbläsarhistorik. Ta bort posten med DeleteUrlCacheEntry. |
Gränssnitt
Internetgenvägsobjektet exponerar ett antal gränssnitt.
OLE-gränssnitt
Gränssnitt för gränssnitt
Funktioner
Det finns flera verktygsfunktioner som kan användas med internetgenvägsobjektet.
Verktygsfunktioner för internetgenvägar