# environment::get-folder-path

[This is preliminary documentation and subject to change.]

Gets the path to the system special folder identified by the specified enumeration.

### Usage

`string environment::get-folder-path(folder)`

### Parameters

Name | Type | Description
--- | --- | ---
folder | SpecialFolder | An enumerated constant that identifies a system special folder.

### Return Value

The path to the specified system special folder, if that folder physically exists on your computer; otherwise, the empty string ("").

### Exceptions

The function will fail in any of the following circumstances:

- folder is not a member of SpecialFolder.

### Examples

- Copy "out.log" from the project base directory to the program files directory.

      <copy file="out.log" todir="${environment::get-folder-path('ProgramFiles')}" />

### Requirements

Assembly: NAnt.Core (0.91.3881.0)