PathCchAddExtension 함수(pathcch.h)

경로 문자열에 파일 이름 확장명을 추가합니다.

이 함수는 "\", "\?" 및 "\?\UNC" 접두사를 사용하여 경로를 허용한다는 점에서 PathAddExtension 과 다릅니다.

참고 버퍼 오버런 가능성을 방지하려면 PathAddExtension 대신 이 함수를 사용해야 합니다.

구문

WINPATHCCHAPI HRESULT PathCchAddExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

[in, out] pszPath

경로 문자열에 대한 포인터입니다. 이 함수가 성공적으로 반환되면 버퍼에 추가된 확장이 있는 문자열이 포함됩니다. 이 값은 NULL이 아니어야 합니다.

참고 원래 문자열에 파일 이름 확장명 이 이미 있는 경우 새 확장명을 추가하지 않으며 원래 문자열은 변경되지 않습니다.

[in] cchPath

pszPath가 가리키는 버퍼의 크기(문자)입니다.

[in] pszExt

파일 이름 확장명 문자열에 대한 포인터입니다. 이 문자열은 이전 마침표(".ext" 또는 "ext")를 사용하거나 사용하지 않고 지정할 수 있습니다.

이 함수는 다음을 포함하여 HRESULT 코드를 반환합니다.

반환 코드	Description
S_OK	함수가 성공했습니다. 여기에는 빈 확장의 경우(예: 문자가 없는 마침표)도 포함됩니다. 이 경우 원래 문자열은 비정형으로 반환됩니다.
E_INVALIDARG	이 값은 pszPath 매개 변수가 NULL로 설정되고 cchPath 가 0으로 설정되거나 PATHCCH_MAX_CCH보다 큰 값 또는 잘못된 문자가 들어 있거나 유효한 확장이 아닌 확장 문자열과 같은 여러 가지로 인해 발생할 수 있습니다.
S_FALSE	원래 문자열에 이미 확장이 있습니다.
PATHCCH_E_FILENAME_TOO_LONG	버퍼가 너무 작아서 반환된 문자열을 보유할 수 없습니다.