PathCchRenameExtension 함수(pathcch.h)

경로 문자열의 끝에 있는 파일 이름의 확장명을 새 확장명으로 바꿉니다. 경로 문자열이 확장으로 끝나지 않으면 새 확장이 추가됩니다.

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

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

구문

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

[in, out] pszPath

경로 문자열에 대한 포인터입니다. 이 함수가 성공적으로 반환되면 이 값은 이름이 변경되거나 확장이 추가된 동일한 문자열을 가리킵니다.

[in] cchPath

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

[in] pszExt

새 확장 문자열에 대한 포인터입니다. 선행 '.' 문자는 선택 사항입니다. 빈 문자열("")의 경우 경로 문자열의 기존 확장이 제거됩니다.

이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.