• *LOCALE_GET Function
• a5_close_system_toolbars Function
• A5_OS_INFO Function
• A5_RESOURCE_INFO Function
• a5_system_function_debug Function
• a5_system_short_time_formatter Function
• a5_system_time_formatter Function
• a5_system_toolbar_editor Function
• a5_toggle_setting Function
• API_GETDOMAINNAME Function
• API_GETENVIRONMENTVAR Function
• API_GETMACHINENAME Function
• API_GETUSERNAME Function
• API_UUIDCREATE Function
• API_UUIDSEQCREATE Function
• DISKSPACE Function
• PROCESS_LIST Function
• Run Function
• SYS_EDIT Function
• SYS_EVENT_LOG Function
• SYS_EVENT_LOG_DUMP Function
• SYS_EXPLORE Function
• SYS_FOCUS_PUT Function
• sys_is_foreground Function
• SYS_KEY_DOWN Function
• sys_key_modifiers Function
• SYS_KEYS_ENUM Function
• SYS_METRIC_GET Function
• SYS_OPEN Function
• SYS_PRINT Function
• SYS_PROPERTIES Function
• SYS_SEND_KEYS Function
• SYS_SHELL Function
• sys_shell_result Function
• SYS_SHELL_WAIT Function
• SYS_SHELL_WAIT_RESULT Function
• sys_window_caret Function
• sys_window_movesize Function
• system_event_add Function
• system_event_invoke Function
• system_event_invoke_query Function
• system_variables Function
• systemfonts_apply Function
• UI_INFO Function
• WIN_1394_INFO Function
• WIN_ACCOUNTS Function
• WIN_BATTERY_INFO Function
• WIN_BIOS_INFO Function
• WIN_CREATE_SHORTCUT Function
• WIN_DISK_INFO Function
• WIN_MEMORY_INFO Function
• WIN_MOTHERBOARD Function
• WIN_SERVICES Function
• WIN_SPECIAL_FOLDER Function

WIN_SPECIAL_FOLDER Function

Syntax

Arguments

FolderPath

The path to the specified Windows special folder.

WindowsFolder

The name of one of the special folders listed in the table below or a NULL string if the folder does not exist.

Description

Returns the path to the Windows special folder specified

Discussion

The WIN_SPECIAL_FOLDER() function returns the path to the specified Windows special folder, such as the Desktop folder, the Start Menu folder, and the Personal Documents folder. Returns an empty string if the requested folder is not available or not valid. For example, Windows 95 does not have an AllUsersDesktop folder and returns an empty string if folder is specified as AllUsersDesktop. The following special folders are available:

Identifier

Folder Contents

AllUsersDesktop

Shortcuts that appear on the desktop for all users.

AllUsersStartMenu

Shortcuts that appear on the Start menu for all users.

AllUsersPrograms

Shortcuts that appear on the Programs menu for all users.

AllUsersStartup

Shortcuts to programs that are run on startup for all users.

Desktop

Shortcuts that appear on the desktop for the current user.

Favorites

Shortcuts saved as favorites by the current user.

Fonts

Fonts installed on the system.

MyDocuments

Current user's documents.

NetHood

Objects that appear in Network Neighborhood.

PrintHood

Printer links.

Recent

Shortcuts to current user's recently opened documents.

SendTo

Shortcuts to applications that show up as possible send-to targets when a user right-clicks on a file in Windows Explorer.

StartMenu

Shortcuts that appear in the current user's start menu.

Startup

Shortcuts to applications that run automatically when the current user logs on to the system.

Templates

Application template files specific to the current user.

Example

? win_special_folder("Desktop") 
= "C:\Documents and Settings\JDoe\Desktop" 

? win_special_folder("MyDocuments") 
= "C:\Documents and Settings\JDoe\My Documents" 

? win_special_folder("Fonts") 
= "C:\WINDOWS\Fonts" 

? win_special_folder("AllUsersDesktop") 
= "C:\Documents and Settings\All Users\Desktop"

See Also

• Directory Functions
• System Functions