SpecialFolders Property 

Returns a SpecialFolders object (a collection of special folders).


object.SpecialFolders(objWshSpecialFolders) 

Arguments

  • object
    WshShell object.
  • objWshSpecialFolders
    The name of the special folder.

Remarks

The WshSpecialFolders object is a collection. It contains the entire set of Windows special folders, such as the Desktop folder, the Start Menu folder, and the Personal Documents folder. The special folder name is used to index into the collection to retrieve the special folder you want. The SpecialFolders property returns an empty string if the requested folder (strFolderName) is not available. For example, Windows 95 does not have an AllUsersDesktop folder and returns an empty string if strFolderNameis AllUsersDesktop.

The following special folders are available:

  • AllUsersDesktop

  • AllUsersStartMenu

  • AllUsersPrograms

  • AllUsersStartup

  • Desktop

  • Favorites

  • Fonts

  • MyDocuments

  • NetHood

  • PrintHood

  • Programs

  • Recent

  • SendTo

  • StartMenu

  • Startup

  • Templates

Legacy Example

The following example demonstrates the use of the SpecialFolders property:

<package>

   <job id="vbs">

      <script language="VBScript">

         set WshShell = WScript.CreateObject("WScript.Shell")

         strDesktop = WshShell.SpecialFolders("Desktop")

         set oShellLink = WshShell.CreateShortcut(strDesktop & "\Shortcut Script.lnk")

         oShellLink.TargetPath = WScript.ScriptFullName

         oShellLink.WindowStyle = 1

         oShellLink.Hotkey = "Ctrl+Alt+e"

         oShellLink.IconLocation = "notepad.exe, 0"

         oShellLink.Description = "Shortcut Script"

         oShellLink.WorkingDirectory = strDesktop

         oShellLink.Save

         set oUrlLink = WshShell.CreateShortcut(strDesktop & "\Microsoft Web Site.url")

         oUrlLink.TargetPath = "https://www.microsoft.com"

         oUrlLink.Save

      </script>

   </job>



   <job id="js">

      <script language="JScript">

         var WshShell = WScript.CreateObject("WScript.Shell");

         strDesktop = WshShell.SpecialFolders("Desktop");

         var oShellLink = WshShell.CreateShortcut(strDesktop + "\\Shortcut Script.lnk");

         oShellLink.TargetPath = WScript.ScriptFullName;

         oShellLink.WindowStyle = 1;

         oShellLink.Hotkey = "Ctrl+Alt+e";

         oShellLink.IconLocation = "notepad.exe, 0";

         oShellLink.Description = "Shortcut Script";

         oShellLink.WorkingDirectory = strDesktop;

         oShellLink.Save();

         var oUrlLink = WshShell.CreateShortcut(strDesktop + "\\Microsoft Web Site.url");

         oUrlLink.TargetPath = "https://www.microsoft.com";

         oUrlLink.Save();

      </script>

   </job>

</package>

Applies To:

WshShell Object

See Also

Reference

WshSpecialFolders Object

Concepts

Running Your Scripts