BROWSEINFOA 구조체(shlobj_core.h)

아티클
03/15/2023

SHBrowseForFolder 함수에 대한 매개 변수를 포함하고 사용자가 선택한 폴더에 대한 정보를 받습니다.

구문

typedef struct _browseinfoA {
  HWND              hwndOwner;
  PCIDLIST_ABSOLUTE pidlRoot;
  LPSTR             pszDisplayName;
  LPCSTR            lpszTitle;
  UINT              ulFlags;
  BFFCALLBACK       lpfn;
  LPARAM            lParam;
  int               iImage;
} BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;

멤버

hwndOwner

형식: HWND

대화 상자의 소유자 창에 대한 핸들입니다.

pidlRoot

형식: PCIDLIST_ABSOLUTE

검색을 시작할 루트 폴더의 위치를 지정하는 PIDL입니다. 지정한 폴더와 네임스페이스 계층 구조의 하위 폴더만 대화 상자에 표시됩니다. 이 멤버는 NULL일 수 있습니다. 이 경우 기본 위치가 사용됩니다.

pszDisplayName

형식: LPTSTR

사용자가 선택한 폴더의 표시 이름을 받을 버퍼에 대한 포인터입니다. 이 버퍼의 크기는 MAX_PATH 문자로 간주됩니다.

lpszTitle

형식: LPCTSTR

대화 상자의 트리 뷰 컨트롤 위에 표시되는 null로 끝나는 문자열에 대한 포인터입니다. 이 문자열을 사용하여 사용자에게 지침을 지정할 수 있습니다.

ulFlags

형식: UINT

대화 상자의 옵션을 지정하는 플래그입니다. 이 멤버는 0이거나 다음 값의 조합일 수 있습니다. 버전 번호는 이후 릴리스에서 추가된 플래그를 인식하기 위해 SHBrowseForFolder 에 필요한 최소 Shell32.dll 버전을 나타냅니다. 자세한 내용은 셸 및 일반 컨트롤 버전을 참조하세요.

BIF_RETURNONLYFSDIRS(0x00000001)

0x00000001. 파일 시스템 디렉터리만 반환합니다. 사용자가 파일 시스템의 일부가 아닌 폴더를 선택하면 확인 단추가 회색으로 표시됩니다.

참고확인 단추는 "\\server" 항목과 "\\server\share" 및 디렉터리 항목에 대해 계속 사용하도록 설정되어 있습니다. 그러나 사용자가 "\\server" 항목을 선택하면 SHBrowseForFolder 에서 반환된 PIDL을 SHGetPathFromIDList 에 전달하지 못합니다.

BIF_DONTGOBELOWDOMAIN(0x00000002)

0x00000002. 대화 상자의 트리 뷰 컨트롤에 도메인 수준 아래에 네트워크 폴더를 포함하지 마세요.

BIF_STATUSTEXT(0x00000004)

0x00000004. 대화 상자에 상태 영역을 포함합니다. 콜백 함수는 대화 상자에 메시지를 보내 상태 텍스트를 설정할 수 있습니다. 이 플래그는 BIF_NEWDIALOGSTYLE 지정한 경우 지원되지 않습니다.

BIF_RETURNFSANCESTORS(0x00000008)

0x00000008. 파일 시스템 상위 항목만 반환합니다. 상위 항목은 네임스페이스 계층 구조의 루트 폴더 아래에 있는 하위 폴더입니다. 사용자가 파일 시스템의 일부가 아닌 루트 폴더의 상위 항목을 선택하면 확인 단추가 회색으로 표시됩니다.

BIF_EDITBOX(0x00000010)

0x00000010. 버전 4.71. 사용자가 항목의 이름을 입력할 수 있는 편집 컨트롤을 찾아보기 대화 상자에 포함합니다.

BIF_VALIDATE(0x00000020)

0x00000020. 버전 4.71. 사용자가 편집 상자에 잘못된 이름을 입력하면 찾아보기 대화 상자에서 BFFM_VALIDATEFAILED 메시지와 함께 애플리케이션의 BrowseCallbackProc을 호출합니다. BIF_EDITBOX 지정되지 않은 경우 이 플래그는 무시됩니다.

BIF_NEWDIALOGSTYLE(0x00000040)

0x00000040. 버전 5.0. 새 사용자 인터페이스를 사용합니다. 이 플래그를 설정하면 크기를 조정할 수 있는 더 큰 대화 상자가 사용자에게 제공됩니다. 대화 상자에는 대화 상자 내의 끌어서 놓기 기능, 순서 변경, 바로 가기 메뉴, 새 폴더, 삭제 및 기타 바로 가기 메뉴 명령을 비롯한 몇 가지 새로운 기능이 있습니다.

참고 COINIT_MULTITHREADED 플래그가 설정된 CoInitializeEx 를 통해 COM이 초기화되면 BIF_NEWDIALOGSTYLE 전달되면 SHBrowseForFolder 가 실패합니다.

BIF_BROWSEINCLUDEURLS(0x00000080)

0x00000080. 버전 5.0. 찾아보기 대화 상자에서 URL을 표시할 수 있습니다. BIF_USENEWUI 및 BIF_BROWSEINCLUDEFILES 플래그도 설정해야 합니다. 이러한 세 가지 플래그 중 어느 것이라도 설정되지 않으면 브라우저 대화 상자에서 URL을 거부합니다. 이러한 플래그가 설정된 경우에도 선택한 항목이 포함된 폴더가 URL을 지원하는 경우에만 찾아보기 대화 상자에 URL이 표시됩니다. 선택한 항목의 특성을 요청하기 위해 폴더의 IShellFolder::GetAttributesOf 메서드가 호출되면 폴더는 SFGAO_FOLDER 특성 플래그를 설정해야 합니다. 그렇지 않으면 찾아보기 대화 상자에 URL이 표시되지 않습니다.

BIF_USENEWUI

버전 5.0. 편집 상자를 포함하여 새 사용자 인터페이스를 사용합니다. 이 플래그는 BIF_EDITBOX | BIF_NEWDIALOGSTYLE.

참고 COINIT_MULTITHREADED 플래그가 설정된 CoInitializeEx 를 통해 COM이 초기화되면 BIF_USENEWUI 전달되면 SHBrowseForFolder 가 실패합니다.

BIF_UAHINT(0x00000100)

0x00000100. 버전 6.0. BIF_NEWDIALOGSTYLE 함께 사용하면 편집 상자 대신 대화 상자에 사용 힌트를 추가합니다. BIF_EDITBOX 이 플래그를 재정의합니다.

BIF_NONEWFOLDERBUTTON(0x00000200)

0x00000200. 버전 6.0. 찾아보기 대화 상자에 새 폴더 단추를 포함하지 마세요.

BIF_NOTRANSLATETARGETS(0x00000400)

0x00000400. 버전 6.0. 선택한 항목이 바로 가기인 경우 대상이 아닌 바로 가기 자체의 PIDL을 반환합니다.

BIF_BROWSEFORCOMPUTER(0x00001000)

0x00001000. 컴퓨터만 반환합니다. 사용자가 컴퓨터가 아닌 항목을 선택하면 확인 단추가 회색으로 나타납니다.

BIF_BROWSEFORPRINTER(0x00002000)

0x00002000. 프린터 선택만 허용합니다. 사용자가 프린터가 아닌 항목을 선택하면 확인 단추가 회색으로 나타납니다.

Windows XP 이상 시스템에서는 Windows XP 스타일 대화 상자를 사용하여 대화 상자의 루트를 프린터 및 팩스 폴더(CSIDL_PRINTERS)로 설정하는 것이 가장 좋습니다.

BIF_BROWSEINCLUDEFILES(0x00004000)

0x00004000. 버전 4.71. 찾아보기 대화 상자에는 파일과 폴더가 표시됩니다.

BIF_SHAREABLE(0x00008000)

0x00008000. 버전 5.0. 찾아보기 대화 상자는 원격 시스템에 공유 가능한 리소스를 표시할 수 있습니다. 이는 로컬 시스템에 원격 공유를 노출하려는 애플리케이션을 위한 것입니다. BIF_NEWDIALOGSTYLE 플래그도 설정해야 합니다.

BIF_BROWSEFILEJUNCTIONS(0x00010000)

0x00010000. Windows 7 이상. 라이브러리 또는 .zip 파일 이름 확장명을 가진 압축 파일과 같은 폴더 접합을 검색할 수 있습니다.

lpfn

형식: BFFCALLBACK

이벤트가 발생할 때 대화 상자에서 호출하는 애플리케이션 정의 함수에 대한 포인터입니다. 자세한 내용은 BrowseCallbackProc 함수를 참조하세요. 이 멤버는 NULL일 수 있습니다.

lParam

형식: LPARAM

lpfn에 지정된 경우 대화 상자가 콜백 함수에 전달하는 애플리케이션 정의 값입니다.

iImage

형식: int

시스템 이미지 목록에 저장된 선택한 폴더와 연결된 이미지의 인덱스를 수신하는 정수 값입니다.

설명

참고

shlobj_core.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 BROWSEINFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	shlobj_core.h(Shlobj.h, Shlobj_core.h 포함)

Share via