GetFileTitleW 함수(commdlg.h)

아티클
08/22/2023

지정된 파일의 이름을 검색합니다.

구문

short GetFileTitleW(
  [in]  LPCWSTR unnamedParam1,
  [out] LPWSTR  Buf,
  [in]  WORD    cchSize
);

매개 변수

[in] unnamedParam1

형식: LPCTSTR

파일의 이름 및 위치입니다.

[out] Buf

형식: LPTSTR

파일의 이름을 받는 버퍼입니다.

[in] cchSize

형식: WORD

lpszTitle 매개 변수가 가리키는 버퍼의 길이(문자)입니다.

반환 값

형식: short

함수가 성공할 경우 반환 값은 0입니다.

파일 이름이 올바르지 않으면 반환 값을 알 수 없습니다. 오류가 있는 경우 반환 값은 음수입니다.

lpszTitle 매개 변수가 가리키는 버퍼가 너무 작으면 반환 값은 필요한 버퍼 크기를 문자 단위로 지정하는 양의 정수입니다. 필요한 버퍼 크기에는 종료 null 문자가 포함됩니다.

설명

GetFileTitle 은 법적 파일 이름으로만 호출해야 합니다. 잘못된 파일 이름을 사용하면 정의되지 않은 결과가 발생합니다.

파일 이름에 필요한 버퍼 크기를 얻으려면 lpszTitle 이 NULL 로 설정되고 cchSize 가 0으로 설정된 함수를 호출합니다. 함수는 필요한 크기를 반환합니다.

GetFileTitle 은 시스템에서 사용자에게 파일 이름을 표시하는 데 사용할 문자열을 반환합니다. 표시 이름에는 파일 이름을 표시하기 위한 사용자의 기본 설정인 경우에만 확장이 포함됩니다. 즉, 반환된 문자열이 파일 시스템 함수 호출에 사용되는 경우 파일을 정확하게 식별하지 못할 수 있습니다.

lpszTitle 버퍼가 너무 작으면 GetFileTitle은 표시 이름을 보유하는 데 필요한 크기를 반환합니다. 그러나 필요한 크기와 lpszFile 버퍼에 원래 지정된 문자 간에는 보장된 관계가 없습니다. 예를 들어 lpszTitle이 NULL로 설정되고 cchSize가 0으로 설정된 GetFileTitle을 호출하지 말고 lpszFile 문자열에 대한 인덱스로 반환 값을 사용하려고 합니다. 일반적으로 strrchr, wcsrchr 및 _mbsrchr 같은 C 런타임 라이브러리 함수를 사용하여 유사한 결과(및 우수한 성능)를 달성할 수 있습니다.

참고

commdlg.h 헤더는 GETFileTitle을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	commdlg.h(Windows.h 포함)
라이브러리	Comdlg32.lib
DLL	Comdlg32.dll
API 세트	ext-ms-win-shell-comdlg32-l1-1-1(Windows 10 버전 10.0.14393에 도입됨)