FileSystem::GetSpecialLocation
파일 시스템의 특수 위치들을 리턴합니다.
GSErrCode GetSpecialLocation (
SpecLocId locId,
Location* result
) const;
파라미터
- locId
- 특수 위치 식별자입니다. 가능한 값들은 다음과 같습니다:
-
식별자 설명 ApplicationFile 실행 중인 애플리케이션입니다. ApplicationFolder 실행 중인 애플리케이션의 부모 폴더입니다. CommonDocuments 모든 사용자들의 Common Documents 폴더입니다. CommonLocalSettings 모든 사용자들의 Common Local Settings 폴더입니다. CurrentFolder 현재 폴더입니다. Desktop 데스크톱 폴더입니다. SharedComponents Shared Components 폴더입니다. System System 폴더입니다. TemporaryFolder 임시 데이터를 위한 폴더입니다. UserDocuments 현재 사용자의 Documents 폴더입니다. UserHome 현재 사용자의 홈 폴더입니다. UserLocalCache 현재 사용자의 Local Application Cache 폴더입니다. UserLocalData 현재 사용자의 Local Application Data 폴더입니다. UserLocalSettings 현재 사용자의 Local Application Settings 폴더입니다. UserRoamingSettings 현재 사용자의 Roaming Settings 폴더입니다. - result
- 리턴 시: 요청한 위치입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| Error* | 불특정 오류입니다. |
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
파일 시스템에는 몇 가지 중요한 특수 위치들이 있습니다. (예. 특정 OS의 데스크톱 폴더의 위치) 이 메소드는 locId로 식별되는 특수 위치를 result에 리턴합니다. 이 메소드가 리턴한 위치에 해당하는 적절한 엔트리가 파일 시스템 안에 있다고 가정할 수 있습니다. 게다가 TemporaryFolder 특수 위치에 해당하는 폴더는 작성 가능합니다.
이 위치들 중 일부는 플랫폼 및 사용자 종속적이고 다른 것들은 실행할 때마다 달라질 수 있음을 참고하십시오. 그래서 특히 멀티 플랫폼 환경에서 이러한 위치들을 영구적인 출력으로 기록하고 다음 실행시 그것들을 사용하는 것은 대체로 잘못된 생각입니다.
실제 플랫폼에서 서로 다른 특수 위치들이 동일한 장소를 참조할 수도 있음을 참고하십시오.
Macintosh 참고:
- CurrentFolder를 쿼리했을 때, ApplicationFolder에 해당하는 위치가 리턴됩니다.
- 만약 파일 시스템에 특정한 특수 위치에 해당하는 엔트리가 존재하지 않으면, 자동으로 생성될 것입니다.
