GetFileTitle

LpszFile 매개 변수에 의해 식별 된 파일 이름을 반환 하는 GetFileTitle 함수.

짧은 GetFileTitle ( LPCTSTR  lpszFile, / / 전체 경로 파일 이름을 파일에 대 한 포인터LPTSTRlpszTitle, / / 포인터는 버퍼를 받는 파일 이름단어cbBuf / / 버퍼의 길이);
 

매개 변수

lpszFile
이름 및 파일의 위치에 대 한 포인터.
lpszTitle
버퍼는 함수는 파일의 이름을 복사 하는 것에 대 한 포인터.
cbBuf
LpszTitle 매개 변수에서 가리키는 버퍼의 문자에서 길이 지정 합니다.

반환 값

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

파일 이름이 유효 하지 않으면 반환 값은 음수입니다.

LpszTitle 매개 변수가 가리키는 버퍼가 너무 작은 경우 반환 값 바이트 (ANSI 버전) 또는 16 비트 문자 (유니코드 버전)에 필요한 버퍼 크기를 지정 하는 양의 정수입니다. 종료 null 문자를 포함 하는 필요한 버퍼 크기.

주의

LpszFile 매개 변수가 가리키는 버퍼 다음 요소를 포함 하는 경우 GetFileTitle 함수는 오류 값을 반환:

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

GetFileTitle 는 시스템에서 사용자에 게 파일을 표시 하는 데 사용할 것 이라고 문자열을 반환 합니다. 표시 이름 그것이 사용자의 기본 설정 파일을 표시 하는 경우에 확장을 포함 합니다. 이 의미는 반환 된 문자열 수 있습니다 정확 하 게 식별 하지 파일 파일 시스템 함수 호출에 사용 되는 경우.

LpszTitle 버퍼가 너무 작은 경우 GetFileTitle 표시 이름을 저장 하는 데 필요한 크기를 반환 합니다. 필요한 크기와 원래 lpszFile 버퍼에 지정 된 문자 사이의 보장 된 연결이 없습니다. 16 비트 Windows 기반 응용 프로그램을 Win32 포트에서 시스템의 이전 버전에서와 같은 동작에 의존 하는 모든 코드를 업데이트 해야 합니다. 가장 일반적인 경우 의도적으로 0, NULL 및 cbBuf 집합에 lpszTitleGetFileTitle 를 호출 하는 코드 이며 다음 lpszFile 문자열에 인덱스로 반환 값을 사용 합니다. 이 기술은 더 이상 지원 합니다. Strrchr, wcsrchr_mbsrchr 와 같은 런타임 라이브러리 함수로 비슷한 결과 (및 뛰어난 성능)을 달성 일반적으로.

QuickInfo

nbsp;?Windows &NT: 버전 3.1 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:지원 되지 않습니다.
헤더:Commdlg.h에 선언 합니다.
가져오기 라이브러리:Comdlg32.lib를 사용 합니다.
유니코드:Windows NT에서 유니코드와 ANSI 버전으로 구현.

참고 항목

공용 대화 상자 라이브러리 개요, 공통 대화 상자 함수 GetOpenFileName, GetSaveFileName

 

Index