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 이상)

추가 정보

GetOpenFileName