Location::Set (6)
위치의 대상을 세트합니다.
GSErrCode Set (
const char* targetPath );
파라미터
- targetPath
-
원하는 대상을 참조하는 파일 시스템 주소(경로)의 (C 문자열 형태의) 텍스트 표현입니다.
현재 플랫폼의 텍스트 표현 또는 URL 표현이 될 수 있습니다. URL 표현은 다음과 같은 구문으로 존재하지 않는 "lan:" 프로토콜(LAN = Local Area Network)을 사용합니다:"lan://" networkAddress "/" localAddress
networkAddress = (networkName ("." networkName)*)? | "localhost"
localAddress = (localName ("/" localName)*)?
'*'는 0 이상, '?'는 0 또는 1 (선택사항) 그리고 '|'는 OR를 의미합니다. networkName은 '.'를 제외한 나머지 문자를 포함할 수 있지만, localName은 '/'를 제외한 나머지 문자를 포함할 수 있습니다.
URL 네트워크 주소(호스트)는 역순으로 표시됩니다. 즉, 왼쪽에서 1번째 파트가 최하위 순서 이름입니다. (반대로 로컬 주소는 "일반" 순서로 표시됩니다. 즉, 왼쪽에서 1번째 파트가 최상위 순서 이름입니다)
예제: "lan://Server.Subnetwork/Share/Folder/File.ext".
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalAddress* | 잘못된 주소가 전달되었습니다. |
| ErrMemoryFull* | 메모리가 부족합니다. |
| Error* | 불특정 오류입니다. |
* Location class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 targetPath로 지정한 대상을 참조하는 위치를 세트합니다.
대상은 반드시 존재할 필요는 없습니다.
인스턴스의 상태가 유효하지 않아도 세트는 제대로 작동합니다. (이것은 인스턴스의 내용과 내부 상태 모두 리셋할 것입니다)
다음 버전부터 이용 가능합니다: 1.0
(더 이상 사용하지 않음)
GSErrCode Set (
const FSSpec& targetSpec );
파라미터
- targetSpec
- 원하는 대상을 참조하는 파일 시스템 주소의 네이티브 Macintosh 표현입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalAddress* | 잘못된 주소가 전달되었습니다. |
| ErrMemoryFull* | 메모리가 부족합니다. |
| Error* | 불특정 오류입니다. |
* Location class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 targetSpec으로 지정한 대상을 참조하는 위치를 세트합니다.
대상은 반드시 존재할 필요는 없지만, targetSpec으로 지정한 볼륨은 반드시 마운트되어 있어야 합니다.
이 메소드는 당연히 플랫폼 종속적입니다.
인스턴스의 상태가 유효하지 않아도 세트는 제대로 작동합니다. (이것은 인스턴스의 내용과 내부 상태 모두 리셋할 것입니다)
다음 버전부터 이용 가능합니다: 1.0
GSErrCode Set (
const GS::UniString& targetPath );
파라미터
- targetPath
- 원하는 대상을 참조하는 파일 시스템 주소(경로)의 (Unicode UTF-16 문자열 형태의) 텍스트 표현입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalAddress* | 잘못된 주소가 전달되었습니다. |
| ErrMemoryFull* | 메모리가 부족합니다. |
| Error* | 불특정 오류입니다. |
* Location class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 생성자는 targetPath로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다.
이 메소드는 targetPath로 지정한 대상을 참조하는 위치를 세트합니다.
대상은 반드시 존재할 필요는 없지만, targetPath으로 지정한 볼륨은 반드시 마운트되어 있어야 합니다.
인스턴스의 상태가 유효하지 않아도 세트는 제대로 작동합니다. (이것은 인스턴스의 내용과 내부 상태 모두 리셋할 것입니다)
다음 버전부터 이용 가능합니다: 1.0
GSErrCode Set (
const FSRef& targetRef
);
파라미터
- targetRef
- 원하는 대상을 참조하는 파일 시스템 주소의 네이티브 Macintosh 표현입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalAddress* | 잘못된 주소가 전달되었습니다. |
| ErrMemoryFull* | 메모리가 부족합니다. |
| Error* | 불특정 오류입니다. |
* Location class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 생성자는 targetRef로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다.
이 메소드는 기존 엔트리들에 대해서만 사용합니다. 이 생성자는 당연히 플랫폼 종속적입니다.
만약 몇 가지 이유로 (또는 메모리가 고갈되어) targetRef가 불법이면, Location 인스턴스의 상태는 유효하지 않게 됩니다.
이 메소드는 targetRef로 지정한 대상을 참조하는 위치를 세트합니다.
대상은 반드시 존재할 필요는 없습니다. 이 메소드는 당연히 플랫폼 종속적입니다.
인스턴스의 상태가 유효하지 않아도 세트는 제대로 작동합니다. (이것은 인스턴스의 내용과 내부 상태 모두 리셋할 것입니다)
다음 버전부터 이용 가능합니다: 1.0
GSErrCode Set (
const CFURLRef& targetURL );
파라미터
- targetUrl
- 원하는 대상을 참조하는 파일 시스템 주소의 네이티브 Macintosh URL 표현입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalAddress* | 잘못된 주소가 전달되었습니다. |
| ErrMemoryFull* | 메모리가 부족합니다. |
| Error* | 불특정 오류입니다. |
* Location class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 생성자는 targetRef로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다.
유효한 CFURL 표현이 없는 위치들이 있다는 것을 참고하십시오. (예. 로컬 루트는 Macintosh 상에서 가상입니다) 그러한 위치들에 대해서는 오류를 리턴합니다.
이 메소드는 targetURL로 지정한 대상을 참조하는 위치를 세트합니다.
CFURL은 위치의 대상에 대한 네이티브 Macintosh URL 표현입니다.
대상은 반드시 존재할 필요는 없습니다.
이 메소드는 당연히 플랫폼 종속적입니다.
인스턴스의 상태가 유효하지 않아도 세트는 제대로 작동합니다. (이것은 인스턴스의 내용과 내부 상태 모두 리셋할 것입니다)
다음 버전부터 이용 가능합니다: 1.0
GSErrCode Set (
POSIXPathSelector selector,
const char* posixPath );
파라미터
- selector
- 파일 시스템의 표준 UNIX 표준이 될 것이라고 정의합니다.
- posixPath
- 원하는 대상을 참조하는 파일 시스템 주소의 표준 UNIX 텍스트 표현입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalAddress* | 잘못된 주소가 전달되었습니다. |
| ErrMemoryFull* | 메모리가 부족합니다. |
| Error* | 불특정 오류입니다. |
* Location class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 targetPath로 지정한 대상을 참조하는 위치를 세트합니다.
원하는 대상은 selector에 의해 파일 시스템의 표준 UNIX 텍스트 표현으로 나타냅니다.
이 메소드는 당연히 플랫폼 종속적입니다.
대상은 반드시 존재할 필요는 없습니다.
다음 버전부터 이용 가능합니다: 1.0
GSErrCode Set (
POSIXPathSelector selector,
const GS::UniString& posixPath );
파라미터
- selector
- 파일 시스템의 표준 UNIX 표준이 될 것이라고 정의합니다.
- posixPath
- 원하는 대상을 참조하는 파일 시스템 주소의 표준 UNIX Unicode UTF-16 텍스트 표현입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalAddress* | 잘못된 주소가 전달되었습니다. |
| ErrMemoryFull* | 메모리가 부족합니다. |
| Error* | 불특정 오류입니다. |
* Location class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 targetPath로 지정한 대상을 참조하는 위치를 세트합니다.
원하는 대상은 selector에 의해 파일 시스템의 표준 UNIX Unicode UTF-16 텍스트 표현으로 나타냅니다.
이 메소드는 당연히 플랫폼 종속적입니다.
대상은 반드시 존재할 필요는 없습니다.
