GetFileNameFromBrowse 함수(shlobj.h)
[이 함수는 Windows XP SP2(서비스 팩 2) 및 Windows Server 2003을 통해 사용할 수 있습니다. 이후 버전의 Windows에서는 변경되거나 사용하지 못할 수 있습니다.]
사용자가 열 파일의 드라이브, 디렉터리 및 이름을 지정할 수 있도록 열기 대화 상자를 만듭니다.
BOOL GetFileNameFromBrowse(
[in, optional] HWND hwnd,
[in, out] PWSTR pszFilePath,
UINT cchFilePath,
[in, optional] PCWSTR pszWorkingDir,
[in] PCWSTR pszDefExt,
[in, optional] PCWSTR pszFilters,
[in, optional] PCWSTR pszTitle
);
[in, optional] hwnd
형식: HWND
대화 상자를 소유하는 창에 대한 핸들입니다. 이 멤버는 유효한 창 핸들이거나 대화 상자에 소유자가 없는 경우 NULL 일 수 있습니다.
[in, out] pszFilePath
형식: PWSTR
파일 이름 편집 컨트롤을 초기화하는 데 사용되는 파일 이름을 포함하는 null로 끝나는 유니코드 문자열입니다. 이 문자열은 OPENFILENAME 구조체의 lpstrFile 멤버에 해당하며 정확히 동일한 방식으로 사용됩니다.
cchFilePath
형식: UINT
종료 null 문자를 포함하여 pszFilePath의 문자 수입니다.
[in, optional] pszWorkingDir
형식: PCWSTR
초기 디렉터리의 정규화된 파일 경로입니다. 이 문자열은 OPENFILENAME 구조체의 lpstrInitialDir 멤버에 해당하며 정확히 동일한 방식으로 사용됩니다.
[in] pszDefExt
형식: PCWSTR
기본 파일 이름 확장명을 포함하는 null로 끝나는 유니코드 문자열입니다. 사용자가 확장을 지정하지 않으면 이 확장이 pszFilePath 에 추가됩니다. 문자열에는 '.' 문자가 포함되어서는 안 됩니다. 이 문자열이 NULL 이고 사용자가 확장을 입력하지 못하면 확장이 추가되지 않습니다.
[in, optional] pszFilters
형식: PCWSTR
필터를 정의하는 null로 끝나는 유니코드 문자열입니다. 이 문자열은 OPENFILENAME 구조체의 lpstrFilter 멤버에 해당하며 정확히 동일한 방식으로 사용됩니다.
[in, optional] pszTitle
형식: PCWSTR
대화 상자의 제목 표시줄에 배치되는 null로 끝나는 유니코드 문자열입니다. 이 값이 NULL이면 시스템에서 기본 제목을 사용합니다.
형식: BOOL
사용자가 파일 이름을 지정하고 확인을 클릭하면 반환 값은 TRUE입니다. pszFilePath가 가리키는 버퍼에는 사용자가 지정하는 전체 경로 및 파일 이름이 포함됩니다. 사용자가 열기 대화 상자를 취소하거나 닫거나 오류가 발생하면 반환 값은 FALSE입니다.
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | shlobj.h(Shlobj.h 포함) |
라이브러리 | Shell32.lib |
DLL | Shell32.dll(버전 5.0 이상) |