BROWSEINFO

BROWSEINFO

SHBrowseForFolder함수로 사용되는 파라미터를 격납해, 유저에게 선택된 폴더의 정보를 받아들입니다.

typedef struct _browseinfo { 
    HWND          hwndOwner; 
    LPCITEMIDLIST pidlRoot; 
    LPTSTR        pszDisplayName; 
    LPCTSTR       lpszTitle; 
    UINT          ulFlags; 
    BFFCALLBACK   lpfn; 
    LPARAM        lParam; 
    int           iImage; 
} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO;

멤버

hwndOwner

표시되는 다이알로그 박스의 오너 윈도우를 지정합니다.

pidlRoot

루트 폴더를 나타내는 아이템ID리스트에의 포인터(PIDL)(을)를 지정합니다.다이알로그 박스에는, 지정된 폴더와 그 서브 폴더만이 표시됩니다.

0 (NULL) (을)를 지정했을 경우에는, 쉘 네임 스페이스의 루트(데스크탑 폴더)가 지정됩니다.

pszDisplayName

유저에게 선택된 아이템의 표시명을 격납하는 버퍼의 주소를 지정합니다.이 버퍼는260 (MAX_PATH) 문자분만큼 확보되어 있지 않으면 안됩니다.

lpszTitle

다이알로그 박스의 트리뷰콘트로르의 상부에 표시되는 문자열의 주소를 지정합니다.

ulFlags

다이알로그 박스의 옵션 플래그를 지정합니다.0또는 이하의 값의 편성을 지정합니다.

0x0001 (BIF_RETURNONLYFSDIRS)

파일 시스템 디렉토리만을 돌려줍니다.그 이외의 아이템이 선택되고 있을 때는,[OK]버튼은 회색 표시가 됩니다.

0x0002 (BIF_DONTGOBELOWDOMAIN)

다이알로그 박스의 트리뷰콘트로르에 도메인 레벨의 네트워크 폴더를 포함하지 않게 합니다.

0x0004 (BIF_STATUSTEXT)

다이알로그 박스에 스테이터스 영역을 표시합니다.표시 텍스트를 설정하려면 , 콜백 함수로부터 다이알로그 박스에 메세지를 송신합니다.

0x0008 (BIF_RETURNFSANCESTORS)

쉘 네임 스페이스 계층 구조 중(안)에서 루트 폴더아래에 있는 파일 시스템 서브 폴더만을 돌려줍니다.그 이외의 아이템이 선택되고 있을 때는,[OK]버튼은 회색 표시가 됩니다.

0x0010 (BIF_EDITBOX)

Version 4.71 이후： 유저가 아이템명을 쓸 수 있는 에디트 컨트롤을 표시합니다.

0x0020 (BIF_VALIDATE)

Version 4.71 이후： 유저가 에디트 컨트롤에 무효인 이름을 입력했을 경우에, BFFM_VALIDATEFAILED 메세지와 함께 콜백 함수가 불려 갑니다.BIF_EDITBOX플래그가 지정되어 있지 않은 경우는, 이 플래그는 무시됩니다.

0x0040 (BIF_NEWDIALOGSTYLE)

Version 5.0 이후： 새로운 유저 인터페이스를 사용합니다.종래의 다이알로그 박스보다 큰, 리사이즈 가능한 다이알로그 박스가 표시되어 다이알로그 박스에의 드래그 앤드 드롭, 폴더의 재정리, 쇼트 컷 메뉴, 새로운 폴더 작성, 삭제, 그 외의 쇼트 컷 메뉴 커멘드가 추가됩니다.이 플래그를 사용하려면 , 미리OleInitialize함수 또는CoInitialize함수를 호출해COM(을)를 초기화해 둘 필요가 있습니다.

0x0050 (BIF_USENEWUI)

Version 5.0 이후： 에디트 컨트롤을 가지는, 새로운 유저 인터페이스를 사용합니다.이 플래그는BIF_EDITBOX|BIF_NEWDIALOGSTYLE(와)과 동등합니다.이 플래그를 사용하려면 , 미리OleInitialize함수 또는CoInitialize함수를 호출해COM(을)를 초기화해 둘 필요가 있습니다.

0x0080 (BIF_BROWSEINCLUDEURLS)

Version 5.0 이후： URL(을)를 표시할 수 있도록(듯이) 합니다.BIF_USENEWUI(와)과BIF_BROWSEINCLUDEFILES하지만 동시에 지정되어 있지 않으면 안됩니다.이러한 플래그가 설정되어 있을 때, 선택된 아이템을 포함한 폴더가 서포트하는 경우에게만,URL하지만 표시됩니다.아이템의 속성을 문의하기 위해서 폴더의IShellFolder::GetAttributesOf 메소드가 불려 갔을 때에, 폴더에 의해서SFGAO_FOLDER속성 플래그가 설정되었을 경우에게만,URL하지만 표시됩니다.

0x0100 (BIF_UAHINT)

Version 6.0 이후： 에디트 컨트롤 대신에, 다이알로그 박스에 용법 힌트를 추가합니다.BIF_NEWDIALOGSTYLE플래그와 함께 지정하지 않으면 안됩니다.

0x0200 (BIF_NONEWFOLDERBUTTON)

Version 6.0 이후： 다이알로그 박스에 「새로운 폴더」버튼을 표시하지 않게 합니다.BIF_NEWDIALOGSTYLE플래그와 함께 지정하지 않으면 안됩니다.

0x0400 (BIF_NOTRANSLATETARGETS)

Version 6.0 이후： 선택된 아이템이 쇼트 컷일 때, 그 링크처가 아니고, 쇼트 컷 파일 자체의PIDL(을)를 돌려줍니다.

0x1000 (BIF_BROWSEFORCOMPUTER)

컴퓨터만을 돌려줍니다.그 이외의 아이템이 선택되고 있을 때는,[OK]버튼은 회색 표시가 됩니다.

0x2000 (BIF_BROWSEFORPRINTER)

프린터만을 돌려줍니다.그 이외의 아이템이 선택되고 있을 때는,OK 버튼은 회색 표시가 됩니다.

0x4000 (BIF_BROWSEINCLUDEFILES)

Version 4.71 이후： 폴더와 파일을 표시합니다.

0x8000 (BIF_SHAREABLE)

Version 5.0 이후： 리모트 시스템상에 있는 공유 자원을 표시할 수 있도록 합니다.BIF_USENEWUI플래그와 함께 지정하지 않으면 안됩니다.

lpfn

이벤트 발생시에 다이알로그 박스로부터 불려 간다BrowseCallbackProc콜백 함수의 주소를 지정합니다.콜백 함수가 필요없는 경우는0 (NULL) (을)를 지정합니다.

lParam

콜백 함수에게 건네지는 어플리케이션 정의치를 지정합니다.

iImage

선택된 폴더와 관련지을 수 있는 이미지의, 시스템 이미지 리스트중에 있어서의 인덱스가 격납됩니다.

대응 정보

Shell32.dll Version 4.00 이후

Windows 95 이후 / Windows NT 4.0 이후

변수와의 대응

HSP변수	멤버
	멤버명	오프셋	사이즈
binfo.0	hwndOwner	0	4
binfo.1	pidlRoot	4	4
binfo.2	pszDisplayName	8	4
binfo.3	lpszTitle	12	4
binfo.4	ulFlags	16	4
binfo.5	lpfn	20	4
binfo.6	lParam	24	4
binfo.7	iImage	28	4