PathMakeUniqueName 함수(shlobj_core.h)

템플릿에서 고유한 경로 이름을 만듭니다.

구문

BOOL PathMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
                 UINT   cchMax,
  [in]           PCWSTR pszTemplate,
  [in, optional] PCWSTR pszLongPlate,
  [in, optional] PCWSTR pszDir
);

매개 변수

[out] pszUniqueName

형식: PWSTR

고유한 경로 이름을 포함하는 null로 끝나는 유니코드 문자열을 수신하는 버퍼입니다. 길이가 최소 MAX_PATH 문자여야 합니다.

cchMax

형식: UINT

pszUniqueName이 가리키는 버퍼의 문자 수입니다.

[in] pszTemplate

형식: PCWSTR

고유한 이름을 생성하는 데 사용되는 템플릿을 포함하는 null로 끝나는 유니코드 문자열입니다. 이 템플릿은 8.3 형식의 파일 이름이 필요한 드라이브에 사용됩니다. 이 문자열은 종결 null 문자를 포함하여 길이가 MAX_PATH 개 이하여야 합니다.

[in, optional] pszLongPlate

형식: PCWSTR

고유한 이름을 생성하는 데 사용되는 템플릿을 포함하는 null로 끝나는 유니코드 문자열입니다. 이 템플릿은 긴 파일 이름을 지원하는 드라이브에 사용됩니다. 이 문자열은 종결 null 문자를 포함하여 길이가 MAX_PATH 개 이하여야 합니다.

[in, optional] pszDir

형식: PCWSTR

새 파일이 있는 디렉터리를 포함하는 null로 끝나는 문자열입니다. 이 문자열은 종결 null 문자를 포함하여 길이가 MAX_PATH 개 이하여야 합니다.

반환 값

형식: BOOL

성공하면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

이 함수는 8.3 형식이 필요한 드라이브의 경우 pszTemplate에 지정된 템플릿을 기반으로 새 고유 파일 이름을 생성하고 긴 파일 이름을 지원하는 드라이브의 경우 pszLongPlate 을 생성합니다. 예를 들어 pszLongPlate에 "My New Filename"을 지정하는 경우 PathMakeUniqueName 은 "My New Filename (1)", "My New Filename (2)" 등의 이름을 반환합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)