IPhotoAcquireSettings::SetOutputFilenameTemplate 메서드(photoacquire.h)

메서드는 SetOutputFilenameTemplate 파일 이름의 형식을 지정하는 서식 문자열(템플릿)을 지정합니다.

구문

HRESULT SetOutputFilenameTemplate(
  [in] LPCWSTR pszTemplate
);

[in] pszTemplate

형식 문자열을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.

형식 문자열에는 경로 리터럴과 토큰이 혼합되어 있습니다. 형식 문자열은 다음과 같습니다.


$(MyPicturesFolder)\$(DateAcquired), $(EventName)\$(EventName) $(SequenceNumber).$(OriginalExtension)

토큰 형식은 다음과 같습니다. 여기서 OptionalPrefix 를 대체 TokenIdentifier 하면 길이가 0인 문자열이 생성되면 및 OptionSuffix 가 표시되지 않습니다.


$([OptionalPrefix]TokenIdentifier:SubToken[OptionalSuffix]|AlternateString)

캐리트("^")는 이스케이프 문자이므로 "^$"는 최종 경로에서 "$"를 생성합니다.

괄호 및 대괄호는 토큰 내에서 리터럴로 허용되지 않지만 토큰 외부에서 사용할 수 있습니다. 즉, 캐럿("^")으로 이스케이프되지 않는 한 하위 토큰 내에서 OptionalString "[", "]", "("또는 ")"를 사용할 수 없습니다.

다음을 포함하여 몇 가지 다른 토큰 클래스가 있습니다.

SHGetSpecialFolder 변수는 다음과 같습니다. 이러한 토큰은 첫 번째 토큰이어야 하며 최대 한 번만 발생할 수 있습니다.

다음과 같은 세션 변수:

다음과 같은 파일 및 메타데이터 변수:

이러한 토큰은 사용자에게 표시될 수 없으므로 지역화되지 않습니다. 예를 들어 $(DateTaken) 은 로캘 또는 언어 설정에 관계없이 모든 버전의 Microsoft Windows에서 동일합니다.

예를 들어 가 "Meghan의 생일"이고 명명 패턴이 다음과 같다고 가정 EventName 합니다.


$(MyPicturesFolder)\$(DateAcquired)$([, ]EventName)\$(EventName[ ])$(SequenceNumber).$(OriginalExtension)

결과 파일의 이름은 다음과 같습니다.

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's birthday 001.jpg

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's birthday 002.jpg

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's birthday 003.jpg

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's birthday 004.jpg