Creating internet shortcuts - Revision history

Anders: /* The .URL file format */

2022-04-23T18:40:30Z

The .URL file format

â† Older revision		Revision as of 18:40, 23 April 2022
Line 62:		Line 62:
	Comment=		Comment=
	Desc=		Desc=

			[InternetShortcut.A]
			; CP_ACP stuff?

			[InternetShortcut.W]
			; UTF-7 stuff?

	[DEFAULT] ; HTML frameset		[DEFAULT] ; HTML frameset
Line 83:		Line 89:

	* Bookmarklet:ExtendedURL allows bookmarklets [https://translate.google.com/translate?sl=auto&tl=en&u=https://habr.com/ru/post/263443/ up to 5119 characters] while the normal InternetShortcut:URL field is limited to 2083 characters.		* Bookmarklet:ExtendedURL allows bookmarklets [https://translate.google.com/translate?sl=auto&tl=en&u=https://habr.com/ru/post/263443/ up to 5119 characters] while the normal InternetShortcut:URL field is limited to 2083 characters.



	== Using the IUniformResourceLocator interface ==		== Using the IUniformResourceLocator interface ==

Anders: /* URLs in .HTM shortcuts */ IE4

2021-12-11T19:35:00Z

URLs in .HTM shortcuts: IE4

â† Older revision		Revision as of 19:35, 11 December 2021
Line 162:		Line 162:
	<meta id="r" http-equiv="refresh" content="1; url=http://example.net/path/?q#f">		<meta id="r" http-equiv="refresh" content="1; url=http://example.net/path/?q#f">
	<script><!--		<script><!--
			if((d=document).all&&!d.getElementById)d.getElementById=function(n){return d.all[n]};
	if((d=document).getElementById){u=d.getElementById("r").content;window.location.replace(u.slice(u.indexOf("=")+1))}		if((d=document).getElementById){u=d.getElementById("r").content;window.location.replace(u.slice(u.indexOf("=")+1))}
	//--></script>		//--></script>
	</head></html>		</head></html>
	</pre>		</pre>

Anders: /* URLs in .HTM shortcuts */ replace is supported if gEBI is there

2021-09-12T14:09:31Z

URLs in .HTM shortcuts: replace is supported if gEBI is there

â† Older revision		Revision as of 14:09, 12 September 2021
Line 162:		Line 162:
	<meta id="r" http-equiv="refresh" content="1; url=http://example.net/path/?q#f">		<meta id="r" http-equiv="refresh" content="1; url=http://example.net/path/?q#f">
	<script><!--		<script><!--
	if((d=document).getElementById){~~if(!(l=window.location).replace)l.replace=function(u){location.href=u};~~u=d.getElementById("r").content;l.replace(u.slice(u.indexOf("=")+1))}		if((d=document).getElementById){u=d.getElementById("r").content;window.location.replace(u.slice(u.indexOf("=")+1))}
	//--></script>		//--></script>
	</head></html>		</head></html>
	</pre>		</pre>

Anders: Added .HTM shortcut

2021-09-12T13:58:42Z

Added .HTM shortcut

@@ Line 83: / Line 83: @@
 * Bookmarklet:ExtendedURL allows bookmarklets [https://translate.google.com/translate?sl=auto&tl=en&u=https://habr.com/ru/post/263443/ up to 5119 characters] while the normal InternetShortcut:URL field is limited to 2083 characters.
@@ Line 149: / Line 150: @@
 * 98 (IE4) stores URLs as ANSI PIDLs: <code>[INTERNET] [,61h:00h:00000000h,http:...] [61h:01h:00000000h,#frag]</code>
 * 98.SE (IE5) stores URLs as Unicode PIDLs: <code>[INTERNET] [,61h:80h:00000000h,h t t p : ...,BEEF...,# f r a g]</code>

Anders: /* URLs in .LNK shortcuts */ Minor PIDL format corrections

2019-09-02T14:55:24Z

URLs in .LNK shortcuts: Minor PIDL format corrections

â† Older revision		Revision as of 14:55, 2 September 2019
Line 146:		Line 146:

	* NT4 (IE2) cannot handle URL PIDLs? <!--(Unable to create working .LNK)-->		* NT4 (IE2) cannot handle URL PIDLs? <!--(Unable to create working .LNK)-->
	* 95.OSR2 (IE3) stores URLs as ANSI PIDLs: <code>[?] [61h,00h,http:...#frag]</code> <!--(Unable to create working .LNK)-->		* 95.OSR2 (IE3) stores URLs as ANSI PIDLs: <code>[?] [,61h,00h,http:...#frag]</code> <!--(Unable to create working .LNK)-->
	* 98 (IE4) stores URLs as ANSI PIDLs: <code>[INTERNET] [61h:00h:00000000h,http:...] [61h:01h:00000000h,#frag]</code>		* 98 (IE4) stores URLs as ANSI PIDLs: <code>[INTERNET] [,61h:00h:00000000h,http:...] [61h:01h:00000000h,#frag]</code>
	* 98.SE (IE5) stores URLs as Unicode PIDLs: <code>[INTERNET] [61h:80h:00000000h,~~http~~:...,BEEF...,#~~frag~~]</code>		* 98.SE (IE5) stores URLs as Unicode PIDLs: <code>[INTERNET] [,61h:80h:00000000h,h t t p : ...,BEEF...,# f r a g]</code>

Anders: Added URL PIDL details

2019-06-04T16:29:50Z

Added URL PIDL details

â† Older revision		Revision as of 16:29, 4 June 2019
Line 29:		Line 29:
	Section		Section

	!insertmacro CreateInternetShortcut "$Desktop\Example1.URL" "http://example.~~com~~"		!insertmacro CreateInternetShortcut "$Desktop\Example1.URL" "http://example.net/path?query#frag"
	!insertmacro CreateInternetShortcutWithIcon "$Desktop\Example2.URL" "http://example.~~net/path?query#frag~~" "$windir\explorer.exe" 13		!insertmacro CreateInternetShortcutWithIcon "$Desktop\Example2.URL" "http://example.com" "$windir\explorer.exe" 13

	SectionEnd		SectionEnd
Line 82:		Line 82:
	</pre></code>		</pre></code>

			* Bookmarklet:ExtendedURL allows bookmarklets [https://translate.google.com/translate?sl=auto&tl=en&u=https://habr.com/ru/post/263443/ up to 5119 characters] while the normal InternetShortcut:URL field is limited to 2083 characters.


Line 137:		Line 138:
	SectionEnd		SectionEnd
	</highlight-nsis>		</highlight-nsis>



			== URLs in .LNK shortcuts ==

			Most Windows versions can parse and store URLs in the shell namespace. Because .LNK shortcut files can contain a [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/cc144089(v=vs.85) PIDL] you can put a PIDL URL in a .LNK shortcut. The result is not ideal because not all Windows versions display the default URL icon correctly. The URL PIDL format is not documented nor stable across all Windows versions.

			* NT4 (IE2) cannot handle URL PIDLs? <!--(Unable to create working .LNK)-->
			* 95.OSR2 (IE3) stores URLs as ANSI PIDLs: <code>[?] [61h,00h,http:...#frag]</code> <!--(Unable to create working .LNK)-->
			* 98 (IE4) stores URLs as ANSI PIDLs: <code>[INTERNET] [61h:00h:00000000h,http:...] [61h:01h:00000000h,#frag]</code>
			* 98.SE (IE5) stores URLs as Unicode PIDLs: <code>[INTERNET] [61h:80h:00000000h,http:...,BEEF...,#frag]</code>

Anders: /* Using the IUniformResourceLocator interface */ Call Commit

2019-02-02T19:37:27Z

Using the IUniformResourceLocator interface: Call Commit

â† Older revision		Revision as of 19:37, 2 February 2019
Line 122:		Line 122:
	!insertmacro IPropertyStorage_WritePropById $3 ${PID_IS_ICONINDEX} $5 ""		!insertmacro IPropertyStorage_WritePropById $3 ${PID_IS_ICONINDEX} $5 ""
	System::Free $5 ; Free PROPVARIANT		System::Free $5 ; Free PROPVARIANT
			${IPropertyStorage::Commit} $3 '(${STGC_DEFAULT})'
	${IUnknown::Release} $3 ""		${IUnknown::Release} $3 ""
	${EndIf}		${EndIf}

Anders: Created page for .URL files

2019-01-30T15:22:33Z

Created page for .URL files

New page

{{PageAuthor|Anders}}
[[Category:Internet Functions]]

== Introduction ==

Internet shortcuts cannot be created with the <code>CreateShortcut</code> NSIS instruction because they are a different file type (.URL, not .LNK).

.URL files are actually just .INI files and can be created/edited with the NSIS INI instructions.

== Writing .URL files directly as a .INI file ==

While technically not the correct way to create .URL files, you can write them directly with the <code>WriteINIStr</code> instruction or use simple helper macros:

<highlight-nsis>
!macro CreateInternetShortcut FILEPATH URL
WriteINIStr "${FILEPATH}" "InternetShortcut" "URL" "${URL}"
!macroend

!macro CreateInternetShortcutWithIcon FILEPATH URL ICONPATH ICONINDEX
WriteINIStr "${FILEPATH}" "InternetShortcut" "URL" "${URL}"
WriteINIStr "${FILEPATH}" "InternetShortcut" "IconIndex" "${ICONINDEX}"
WriteINIStr "${FILEPATH}" "InternetShortcut" "IconFile" "${ICONPATH}"
!macroend
</highlight-nsis>

<highlight-nsis>
Section

!insertmacro CreateInternetShortcut "$Desktop\Example1.URL" "http://example.com"
!insertmacro CreateInternetShortcutWithIcon "$Desktop\Example2.URL" "http://example.net/path?query#frag" "$windir\explorer.exe" 13

SectionEnd
</highlight-nsis>


== The .URL file format ==

The .URL file format is not officially documented. Only the URL value in the InternetShortcut section is required, everything else is optional.

<code><pre>
[InternetShortcut]
URL=
HotKey=
IconFile=
IconIndex=
ShowCommand=
Modified=
Roamed=
IDList=
Author=
WhatsNew=
Comment=
Desc=

[DEFAULT] ; HTML frameset
BASEURL=

[DOC<NestedFramesetInfo>]
BASEURL=
ORIGURL=

[Bookmarklet] ; JavaScript bookmarklet
ExtendedURL=

[MonitoredItem]
FeedUrl=
IsLivePreview=
PreviewSize=

[{000214A0-0000-0000-C000-000000000046}] ; FMTID_Intshcut property storage
Prop<2..2147483647>=
</pre></code>

== Using the IUniformResourceLocator interface ==

Using the IUniformResourceLocator interface is the [https://docs.microsoft.com/en-us/windows/desktop/lwef/internet-shortcuts#creating-an-internet-shortcut-from-a-url documented] way to create/read/write .URL files.

IUniformResourceLocator helper macros were added in NSIS v3.05.

<highlight-nsis>
!include LogicLib.nsh
!include Win\COM.nsh
!include Win\PropKey.nsh

Section

!insertmacro ComHlpr_CreateInProcInstance ${CLSID_InternetShortcut} ${IID_IUniformResourceLocator} r1 ""
${If} $1 P<> 0
${IUniformResourceLocator::SetURL} $1 '("http://example.com?simple")'
${IUnknown::QueryInterface} $1 '("${IID_IPersistFile}",.r2)'
${If} $2 P<> 0
${IPersistFile::Save} $2 '("$Desktop\Example4.URL",1)'
${IUnknown::Release} $2 ""
${EndIf}
${IUnknown::Release} $1 ""
${EndIf}

!insertmacro ComHlpr_CreateInProcInstance ${CLSID_InternetShortcut} ${IID_IUniformResourceLocator} r1 ""
${If} $1 P<> 0
${IUniformResourceLocator::SetURL} $1 '("http://example.com?propstorage")'
${IUnknown::QueryInterface} $1 '("${IID_IPropertySetStorage}",.r2)'
${If} $2 P<> 0
${IPropertySetStorage::Open} $2 '("${FMTID_Intshcut}", ${STGM_READWRITE}, .r3)'
${If} $3 P<> 0
System::Call '*${SYSSTRUCT_PROPVARIANT}(${VT_LPWSTR},,,&w${NSIS_MAX_STRLEN} "$windir\explorer.exe")p.r5' ; Allocate PROPVARIANT + string buffer
IntPtrOp $6 $5 + ${SYSSIZEOF_PROPVARIANT} ; Calculate string address
${V_SetPointer} $5 "" $6
!insertmacro IPropertyStorage_WritePropById $3 ${PID_IS_ICONFILE} $5 ""
${V_SetInt32} $5 ${VT_I4} 8
!insertmacro IPropertyStorage_WritePropById $3 ${PID_IS_ICONINDEX} $5 ""
System::Free $5 ; Free PROPVARIANT
${IUnknown::Release} $3 ""
${EndIf}
${IUnknown::Release} $2 ""
${EndIf}
${IUnknown::QueryInterface} $1 '("${IID_IPersistFile}",.r2)'
${If} $2 P<> 0
${IPersistFile::Save} $2 '("$Desktop\Example5.URL",1)'
${IUnknown::Release} $2 ""
${EndIf}
${IUnknown::Release} $1 ""
${EndIf}

SectionEnd
</highlight-nsis>