因特網快捷方式
因特網快捷方式對象可用來建立因特網網站的桌面快捷方式。 就像文件系統中專案的快捷方式一樣,因特網快捷方式會採用桌面上的圖示形式。 當使用者按一下圖示時,會啟動瀏覽器,並顯示與快捷方式相關聯的網站。
下列主題會討論。
建立因特網快捷方式
您可以使用 WebBrowser 控制項或頁面的 URL 來建立因特網快捷方式。
從 WebBrowser 控制項建立因特網快捷方式
如果您的應用程式裝載 WebBrowser 控制件,您可以使用因特網快捷方式物件,以下列方式建立快捷方式。
- 使用 CLSID_InternetShortcut 的類別標識碼 (CLSID) 建立具有 CoCreateInstance的因特網快捷方式對象的實例。
- 使用 IObjectWithSite::SetSite,將 WebBrowser IUnknown 介面的指標傳遞至因特網快捷方式物件。
- 當您想要建立 WebBrowser 控制項所檢視之頁面的快捷方式時,呼叫因特網快捷方式物件的 IPersistFile::Save 方法。
會在 IPersistFile::Save中指定的位置建立快捷方式。 此位置可讓 WebBrowser 控制項還原其狀態,包括將正確檔載入框架集的工作。
從 URL 建立因特網快捷方式
如果您有要連結的頁面 URL,您也可以建立因特網快捷方式。
- 使用 CLSID_InternetShortcut 的 CLSID,使用 CoCreateInstance建立因特網快捷方式對象的實例。
- 使用 IUniformResourceLocator::SetURL 方法,在快捷方式中設定 URL。
- 使用 IPersistFile::Save 方法,將快捷方式檔案儲存到所需的位置。
存取屬性記憶體
因特網快捷方式物件包含數個屬性,您可以使用下列程式,透過物件的 IPropertySetStorage 介面進行存取。
- 使用 IID_IPropertySetStorage 呼叫 QueryInterface,以取得 IPropertySetStorage 介面。
- 使用 FMTID_Intshcut 或 FMTID_InternetSite 呼叫 IPropertySetStorage::Open,以取得 IPropertyStorage 介面,以存取因特網快捷方式屬性記憶體集。
- 傳遞適當的屬性標識碼,以 IPropertyStorage::ReadMultiple 讀取屬性記憶體資訊。
使用 Shell32.dll4.70 版或更高版本的,您也可以呼叫 IShellFolder::BindToStorage,並將 pidl 參數設定為 來擷取 IPropertySetStorage 介面。URL 檔案和 riid 參數設定為 IID_IPropertySetStorage。
您可以針對FMTID_Intshcut要求下列屬性識別碼。
PROPID | Variant 類型 | 描述 |
---|---|---|
PID_IS_URL | VT_LPWSTR | 快捷方式所指向的 URL |
PID_IS_NAME | VT_LPWSTR | 因特網快捷方式的名稱 |
PID_IS_WORKINGDIR | VT_LPWSTR | 快捷方式的工作目錄 |
PID_IS_HOTKEY | VT_UI2 | 快速鍵的快速鍵 |
PID_IS_SHOWCMD | VT_I4 | 顯示快捷方式的命令 |
PID_IS_ICONINDEX | VT_I4 | 圖示的索引 |
PID_IS_ICONFILE | VT_LPWSTR | 包含圖示的檔案 |
PID_IS_WHATSNEW | VT_LPWSTR | 新增文字 |
PID_IS_AUTHOR | VT_LPWSTR | 作者 |
PID_IS_DESCRIPTION | VT_LPWSTR | 網站的描述文字 |
PID_IS_COMMENT | VT_LPWSTR | 使用者批註批注批注 |
PID_IS_ROAMED | VT_BOOL | True 是表示 第一次漫遊快捷方式 |
您可以針對FMTID_InternetSite要求下列屬性標識碼。
PROPID | Variant 類型 | 描述 |
---|---|---|
PID_INTSITE_WHATSNEW | VT_LPWSTR | 新增文字 |
PID_INTSITE_AUTHOR | VT_LPWSTR | 作者 |
PID_INTSITE_LASTVISIT | VT_FILETIME | 上次瀏覽時間網站 |
PID_INTSITE_LASTMOD | VT_FILETIME | 上次修改時間網站 |
PID_INTSITE_VISITCOUNT | VT_UI4 | 用戶瀏覽次數 |
PID_INTSITE_DESCRIPTION | VT_LPWSTR | 網站的描述文字 |
PID_INTSITE_COMMENT | VT_LPWSTR | 使用者批註批注批注 |
PID_INTSITE_FLAGS | VT_UI4 | 表示使用PIDISF_旗標(請參閱下方) |
PID_INTSITE_CONTENTLEN | N/A | 目前不支援 |
PID_INTSITE_CONTENTCODE | N/A | 目前不支援 |
PID_INTSITE_RECURSE | N/A | 目前不支援 |
PID_INTSITE_WATCH | N/A | 目前不支援 |
PID_INTSITE_SUBSCRIPTION | VT_UI8 | 訂用帳戶管理員的 SUBSCRIPTIONCOOKIE 值 |
PID_INTSITE_URL | VT_LPWSTR | 快捷方式所指向的 URL |
PID_INTSITE_TITLE | VT_LPWSTR | 標題 |
PID_INTSITE_CODEPAGE | VT_UI4 | 檔的代碼頁 |
PID_INTSITE_TRACKING | N/A | 目前不支援 |
PID_INTSITE_ICONINDEX | VT_I4 | 圖示的索引 |
PID_INTSITE_ICONFILE | VT_LPWSTR | 包含圖示的檔案 |
PID_INTSITE_ROAMED | VT_UI4 | 專案已新增,因為漫遊 |
以下是因特網網站旗標。
旗 | 描述 |
---|---|
PIDISF_RECENTLYCHANGED | 指出網站最近已變更 |
PIDISF_CACHEDSTICKY | 目前不支援 |
PIDISF_CACHEIMAGES | 目前不支援 |
PIDISF_FOLLOWALLLINKS | 目前不支援 |
下列值用於因特網漫遊歷程記錄。
PID_INTSITE_ROAMED值 | 描述 |
---|---|
未設定或PIDISR_UP_TO_DATE | 漫遊尚未修改此快取專案。 |
PIDISR_NEEDS_ADD | 此快取專案已藉由漫遊新增至快取。 完成專案處理之後,請設定PIDISR_UP_TO_DATE。 |
PIDISR_NEEDS_UPDATE | 此快取專案已存在於本機計算機上,但已透過漫遊進行更新。 完成專案處理之後,請設定PIDISR_UP_TO_DATE。 |
PIDISR_NEEDS_DELETE | 漫遊偵測到應該刪除此快取專案。 例如,使用者可能已清除其瀏覽器歷程記錄。 使用 DeleteUrlCacheEntry 刪除專案。 |
介面
因特網快捷方式對象會公開許多介面。
OLE 介面
殼層介面
功能
有數個公用程式函式可以搭配因特網快捷方式物件使用。
因特網快捷方式公用程式函式