Compartir a través de

Accesos directos a Internet

  • Artículo

El objeto de método abreviado de Internet se usa para crear accesos directos de escritorio a sitios de Internet. Al igual que los accesos directos a los elementos del sistema de archivos, los accesos directos a Internet toman la forma de un icono en el escritorio. Cuando el usuario hace clic en el icono, se inicia el explorador y se muestra el sitio asociado al acceso directo.

Se tratan los temas siguientes.

Creación de accesos directos a Internet

Puede crear un acceso directo a Internet mediante un control WebBrowser o con la dirección URL de la página.

Crear un acceso directo a Internet desde un control WebBrowser

Si la aplicación hospeda un control WebBrowser, puede usar el objeto de método abreviado de Internet para crear accesos directos de la siguiente manera.

  1. Cree una instancia del objeto de método abreviado de Internet con CoCreateInstance mediante un identificador de clase (CLSID) de CLSID_InternetShortcut.
  2. Pase el puntero a la interfaz IUnknown de WebBrowser al objeto de acceso directo de Internet con IObjectWithSite::SetSite.
  3. Llame al método IPersistFile::Save del objeto de acceso directo de Internet cuando desee crear un acceso directo a la página que ve el control WebBrowser.

Se creará un acceso directo en la ubicación especificada en IPersistFile::Save. Esta ubicación permite al control WebBrowser restaurar su estado, que incluye la tarea de cargar los documentos correctos en conjuntos de marcos.

Crear un acceso directo a Internet desde una dirección URL

También puede crear un acceso directo a Internet si tiene la dirección URL de la página a la que desea vincular.

  1. Cree una instancia del objeto de acceso directo de Internet con CoCreateInstance mediante un CLSID de CLSID_InternetShortcut.
  2. Use el método IUniformResourceLocator::SetURL para establecer la dirección URL en el acceso directo.
  3. Use el método IPersistFile::Save para guardar el archivo de acceso directo en una ubicación deseada.

Acceso al almacenamiento de propiedades

El objeto de método abreviado de Internet contiene varias propiedades a las que puede acceder a través de la interfaz IPropertySetStorage del objeto con el procedimiento siguiente.

  1. Obtenga la interfaz IPropertySetStorage llamando a QueryInterface con IID_IPropertySetStorage.
  2. Acceda al conjunto de almacenamiento de propiedades de acceso directo de Internet llamando a IPropertySetStorage::Open con FMTID_Intshcut o FMTID_InternetSite para obtener la interfaz IPropertyStorage .
  3. Lea la información de almacenamiento de propiedades con IPropertyStorage::ReadMultiple pasando el identificador de propiedad adecuado.

Con la versión 4.70 o posterior de Shell32.dll, también puede recuperar la interfaz IPropertySetStorage llamando a IShellFolder::BindToStorage con el parámetro pidl establecido en . Archivo de dirección URL y el parámetro riid establecido en IID_IPropertySetStorage.

Se pueden solicitar los siguientes identificadores de propiedad para FMTID_Intshcut.

PROPID Tipo de variante Descripción
PID_IS_URL VT_LPWSTR Dirección URL a la que dirige el acceso directo
PID_IS_NAME VT_LPWSTR Nombre del acceso directo a Internet
PID_IS_WORKINGDIR VT_LPWSTR Directorio de trabajo para el acceso directo
PID_IS_HOTKEY VT_UI2 Tecla de acceso rápido para el acceso directo
PID_IS_SHOWCMD VT_I4 Mostrar comando para acceso directo
PID_IS_ICONINDEX VT_I4 Índice del icono
PID_IS_ICONFILE VT_LPWSTR Archivo que contiene el icono
PID_IS_WHATSNEW VT_LPWSTR Novedades del texto
PID_IS_AUTHOR VT_LPWSTR Autor
PID_IS_DESCRIPTION VT_LPWSTR Texto de descripción del sitio
PID_IS_COMMENT VT_LPWSTR Comentario anotado por el usuario
PID_IS_ROAMED VT_BOOL True cuando el acceso directo se desplaza por primera vez

 

Se pueden solicitar los siguientes identificadores de propiedad para FMTID_InternetSite.

PROPID Tipo de variante Descripción
PID_INTSITE_WHATSNEW VT_LPWSTR Novedades del texto
PID_INTSITE_AUTHOR VT_LPWSTR Autor
PID_INTSITE_LASTVISIT VT_FILETIME Hora en la que se visitó por última vez el sitio
PID_INTSITE_LASTMOD VT_FILETIME Hora en la que se modificó por última vez el sitio
PID_INTSITE_VISITCOUNT VT_UI4 Número de veces que el usuario ha visitado
PID_INTSITE_DESCRIPTION VT_LPWSTR Texto de descripción del sitio
PID_INTSITE_COMMENT VT_LPWSTR Comentario anotado por el usuario
PID_INTSITE_FLAGS VT_UI4 Indica el uso de marcas de PIDISF_ (consulte a continuación)
PID_INTSITE_CONTENTLEN No aplicable No se admite actualmente.
PID_INTSITE_CONTENTCODE No aplicable No se admite actualmente.
PID_INTSITE_RECURSE No aplicable No se admite actualmente.
PID_INTSITE_WATCH No aplicable No se admite actualmente.
PID_INTSITE_SUBSCRIPTION VT_UI8 VALOR SUBSCRIPTIONCOOKIE para el administrador de suscripciones
PID_INTSITE_URL VT_LPWSTR Dirección URL a la que dirige el acceso directo
PID_INTSITE_TITLE VT_LPWSTR Título
PID_INTSITE_CODEPAGE VT_UI4 Página de códigos del documento
PID_INTSITE_TRACKING No aplicable No se admite actualmente.
PID_INTSITE_ICONINDEX VT_I4 Índice del icono
PID_INTSITE_ICONFILE VT_LPWSTR Archivo que contiene el icono
PID_INTSITE_ROAMED VT_UI4 La entrada se agregó debido a la itinerancia

 

A continuación se muestran las marcas de sitio de Internet.

Marca Descripción
PIDISF_RECENTLYCHANGED Indica que un sitio ha cambiado recientemente.
PIDISF_CACHEDSTICKY No se admite actualmente.
PIDISF_CACHEIMAGES No se admite actualmente.
PIDISF_FOLLOWALLLINKS No se admite actualmente.

 

Los siguientes valores se usan para el historial de itinerancia de Internet.

Valor de PID_INTSITE_ROAMED Descripción
Valor no establecido o PIDISR_UP_TO_DATE Esta entrada de caché no se ha modificado mediante itinerancia.
PIDISR_NEEDS_ADD Esta entrada de caché se agregó a la memoria caché mediante itinerancia. Establezca PIDISR_UP_TO_DATE una vez completado el procesamiento de la entrada.
PIDISR_NEEDS_UPDATE Esta entrada de caché ya existía en el equipo local, pero se actualizó mediante itinerancia. Establezca PIDISR_UP_TO_DATE una vez completado el procesamiento de la entrada.
PIDISR_NEEDS_DELETE La itinerancia detectó que se debe eliminar esta entrada de caché. Por ejemplo, el usuario puede haber borrado su historial del explorador. Elimine la entrada mediante DeleteUrlCacheEntry.

 

Interfaces

El objeto de método abreviado de Internet expone una serie de interfaces.

interfaces OLE

Interfaces de shell

Functions

Hay varias funciones de utilidad que se pueden usar con el objeto de método abreviado de Internet.

Funciones de la utilidad de método abreviado de Internet