GetSaveFileName(A)

GetSaveFileName(A)

유저가 보존하는 파일명을 지정하기 위한 「보존」다이알로그 박스를 작성합니다.

BOOL GetSaveFileNameA(
    LPOPENFILENAME pofn
);

COMDLG32.DLL

인수

pofn

다이알로그 박스를 초기화하기 위해서 사용된다 OPENFILENAME구조체의 주소를 지정합니다.함수로부터 제어가 돌아가면, 유저가 선택한 파일에 관한 정보가 격납됩니다.

반환값

유저가 파일명을 지정해 「OK」버튼을 누르면, 반환값은0이외의 값이 됩니다. OPENFILENAME구조체의lpstrFile멤버가 가리키는 버퍼에, 유저가 선택한 파일의 풀 패스와 파일명이 격납됩니다.

유저가 다이아로그복크를 캔슬 또는 닫았을 경우, 혹은 에러가 발생했을 경우에는, 반환값은0(이)가 됩니다.확장 에러 정보를 취득하려면 ,CommDlgExtendedError함수를 사용합니다.이 함수는 이하의 몇개의 값을 돌려줍니다.

0xFFFF (CDERR_DIALOGFAILURE)

0x0001 (CDERR_STRUCTSIZE)

0x0002 (CDERR_INITIALIZATION)

0x0003 (CDERR_NOTEMPLATE)

0x0004 (CDERR_NOHINSTANCE)

0x0005 (CDERR_LOADSTRFAILURE)

0x0006 (CDERR_FINDRESFAILURE)

0x0007 (CDERR_LOADRESFAILURE)

0x0008 (CDERR_LOCKRESFAILURE)

0x0009 (CDERR_MEMALLOCFAILURE)

0x000A (CDERR_MEMLOCKFAILURE)

0x000B (CDERR_NOHOOK)

0x3001 (FNERR_SUBCLASSFAILURE)

0x3002 (FNERR_INVALIDFILENAME)

0x3003 (FNERR_BUFFERTOOSMALL)

해설

익스플로러 스타일의 「연다」다이알로그 박스는,Windows익스플로러를 닮은 유저 인터페이스의 특징을 가집니다.이 다이알로그 박스에서는,OFNHookProc훅 프로시저를 실장할 수 있습니다.훅 프로시저를 유효하게 하려면 , OPENFILENAME구조체의Flags멤버에OFN_EXPLORER및OFN_ENABLEHOOK플래그를 지정해,lpfnHook멤버에 훅 프로시저의 주소를 지정합니다.

Windows그럼 계속 올드스타일의 「연다」다이알로그 박스를 서포트합니다.올드스타일 다이알로그 박스를 표시하려면 ,OFNHookProcOldStyle훅 프로시저를 유효하게 해,OFN_EXPLORER플래그를 설정하지 않게 합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후