49.2 Special Windows Macros

A special Windows macro is one that defines Windows 98 and Windows 2000/XP directories. The typical paths listed below are based on default installations and might or might not match your specific setup. On Windows 98 workstations, macros behave differently if User Profiles are enabled.

Suppose that you have installed Windows to drive d: (for example, d:\winnt). However, an application installation expects Windows to be on drive c: (for example, c:\winnt). Using the *WinDisk macro, you can substitute drive d: with the macro for the files that require it.

The following two sections describe the special Windows macros you can use.

For information about using the macros in a valid Application object property, see Section 49.8, Application Object Properties Where Macros Can Be Used.

49.2.1 Windows 98 and Windows 2000/XP Macros

The following macros apply to Windows 98 and Windows 2000/XP unless otherwise noted.

IMPORTANT:The asterisk character (*) is a required syntax for these macros. Don’t confuse these asterisk characters with the Novell trademark asterisk. In addition, when using the macro in one of the Application object’s property fields, you must enclose it in % characters (for example, %*WinDisk%).

Table 49-1 Windows 98 and Windows 2000/XP Macros

Macro

Description

%*AppData%

File system directory that serves as a common repository for application specific data. Typically c:\winnt\profiles\user name\application data. Used only by Windows NT version 4.

%*CommonDesktop%

File system directory that contains files and folders that appear on the desktop for all users. Typically c:\winnt\profiles\all users\desktop. If not available, the *DESKTOP value is used.

%*CommonPrograms%

File system directory that contains the directories for the common program groups that appear on the Start menu for all users. Typically c:\winnt\profiles\all users\start menu\programs. If not available, the *PROGRAMS value is used.

%*CommonStartMenu%

File system directory that contains the programs and folders that appear on the Start menu for all users. Typically c:\winnt\profiles\all users\start menu. If not available, the *STARTMENU value is used.

%*CommonStartup%

File system directory that contains the programs that appear in the Startup folder for all users. The system starts these programs whenever any user logs on to Windows NT 4 or starts Windows 98. Typically this directory is c:\winnt\profiles\all users\start menu\programs\startup. If not available, the *STARTUP value is used.

%*CommonWinDesktop%

Windows NT 4 common desktop directory (c:\winnt\profiles\all users\desktop). This is an Application Launcher 2.0 macro that is allowed for backward compatibility.

%*Cookies%

Files system directory that contains the user’s cookies. Typically c:\windows\cookies or c:\winnt\profiles\username\cookies.

%*Desktop%

File system directory used to physically store file objects on the desktop (not to be confused with the desktop folder itself). Typically this directory is c:\windows\desktop or c:\winnt\profiles\username\desktop.

%*Favorites%

File system directory that serves as a common repository for the user’s favorite items. Typically this directory is c:\windows\favorites or c:\winnt\profiles\username\favorites.

%*Fonts%

Virtual folder containing fonts. Typically c:\windows\fonts or c:\winnt\fonts.

%*History%

File system directory that contains the user’s history of visited Internet addresses. Typically c:\windows\history or c:\winnt\profiles\username\history.

%*NetHood%

File system directory containing objects that appear in the network neighborhood. Typically c:\windows\nethood or c:\winnt\profiles\username\nethood.

%*Personal%

File system directory that serves as a common repository for documents. Typically c:\myfiles or c:\winnt\profiles\username\personal.

%*PrintHood%

File system directory that serves as a common repository for printer links. Typically c:\winnt\profiles\username\printhood. Only used by Windows NT 4.

%*Programs%

File system directory that contains the user’s program groups (which are also file system directories). Typically c:\windows\start menu\programs or c:\winnt\profiles\username\start menu\programs.

%*Recent%

File system directory that contains the user’s most recently used documents. Typically c:\windows\recent or c:\winnt\profiles\username\recent.

%*SendTo%

File system directory that contains Send To menu items. Typically c:\windows\sento or c:\winnt\profiles\username\sendto.

%*StartMenu%

File system directory containing Start menu items. Typically c:\windows\start menu or c:\winnt\profiles\username\start menu.

%*Startup%

File system directory that corresponds to the user’s Startup program group. Typically c:\windows\start menu\programs\startup or c:\winnt\profiles\username\start menu\programs\startup.

%*TempDir%

Windows temporary directory (c:\windows\temP).

%*Templates%

File system directory that serves as a common repository for document templates. Typically c:\windows\shellnew or c:\winnt\shellnew.

%*WinDesktop%

Windows desktop directory (c:\windows\desktop or c:\winnt\profiles\username\desktop for Windows NT 4). This is an Application Launcher 2.0 macro that is allowed for backward compatibility.

%*WinDir%

Windows directory. Typically c:\windows or c:\winnt.

%*WinDisk%

Drive letter (plus colon) for the Windows directory. Typically c:.

%*WinSysDir%

Windows system directory. Typically c:\windows\system or c:\winnt\system32.

%*WinSysDisk%

Drive letter (plus colon) for the Windows system directory. Typically c:.

49.2.2 Windows 2000/XP Macros

The following macros apply to Windows 2000/XP only.

IMPORTANT:The asterisk character (*) is a required syntax for these macros. Don’t confuse these asterisk characters with the Novell trademark asterisk. In addition, when using the macro in one of the Application object’s property fields, you must enclose it in% characters (for example, %*WinDisk%).

Table 49-2 Windows 2000/XP Macros

Macro

Description

%*AdminTools%

File system directory that contains the administrative tools that appear in the Control Panel when a specific user logs in to Windows 2000/XP. Typically c:\documents and settings\username\start menu\programs\administrative tools.

%*CommonAdminTools%

File system directory that contains the administrative tools that appear in the Control Panel for all users who log in to Windows 2000/XP. Typically c:\documents and settings\all users\start menu\programs\administrative tools.

%*CommonAppData%

File system directory that contains the application-specific data for all users who log in to Windows 2000/XP. Typically c:\documents and settings\all users\application data.

%*CommonDocuments%

File system directory that contains the documents shared by all users who log in to Windows 2000/XP. Typically c:\documents and settings\all users\documents.

%*CommonTemplates%

File system directory that contains the document templates shared by all users who log in to Windows 2000/XP. Typically c:\documents and settings\all users\templates.

%*MyPictures%

File system directory that contains a specific user’s graphics files. Typically c:\documents and settings\username\my documents\my pictures.

%*ProgramFiles%

File system directory that contains the program files. Typically c:\program files.

%*ProgramFilesCommon%

File system directory that contains the program files shared by multiple applications. Typically c:\program files\common.

%*UserProfile%

File system directory that contains the logged-in user’s profile. Typically c:\documents and settingS\username.