GetFileTitleA 함수(commdlg.h)

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

통사론

short GetFileTitleA(
  [in]  LPCSTR unnamedParam1,
  [out] LPSTR  Buf,
  [in]  WORD   cchSize
);

매개 변수

[in] unnamedParam1

형식: LPCTSTR

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

[out] Buf

형식: LPTSTR

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

[in] cchSize

형식: WORD

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

반환 값

형식: 짧은

함수가 성공하면 반환 값은 0입니다.

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

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

발언

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

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

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

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

요구 사항

참고 항목

일반 대화 상자 라이브러리

개념

GetOpenFileName

GetSaveFileName

참조