IShellBrowser::BrowseObject 메서드(shobjidl_core.h)

Windows Explorer 다른 폴더로 이동하도록 알릴 수 있습니다.

구문

HRESULT BrowseObject(
  PCUIDLIST_RELATIVE pidl,
  UINT               wFlags
);

매개 변수

pidl

형식: PCUIDLIST_RELATIVE

개체의 위치를 지정하는 ITEMIDLIST (항목 식별자 목록) 구조체의 주소입니다. 이 값은 wFlags 매개 변수에 설정된 플래그 또는 플래그에 따라 달라집니다.

wFlags

형식: UINT

검색할 폴더를 지정하는 플래그입니다. 다음 값 중 0개 이상일 수 있습니다.

이러한 플래그는 다른 창을 만들 것인지 여부를 지정합니다.

SBSP_DEFBROWSER(0x0000)

보기 옵션(새 창을 만들거나 현재 위치에서 찾아보기 위한 사용자 설정)을 준수하는 기본 동작을 사용합니다. 대부분의 경우 호출 애플리케이션이이 플래그를 사용 해야 합니다.

SBSP_SAMEBROWSER

동일한 Windows Explorer 창이 있는 다른 폴더로 이동합니다.

SBSP_NEWBROWSER

지정된 폴더에 대한 다른 창을 만듭니다.

다음 플래그는 모드를 지정합니다. 이러한 값은 SBSP_SAMEBROWSER 지정되거나 SBSP_DEFBROWSER 지정되고 사용자가 바로 찾아보기를 선택한 경우 무시됩니다.

SBSP_DEFMODE

현재 창을 사용합니다.

SBSP_OPENMODE

새 찾아보기 창에 대한 폴더 트리를 지정하지 않습니다. 현재 브라우저가 찾아보기 개체 호출의 SBSP_OPENMODE 일치하지 않으면 새 창이 열립니다.

SBSP_EXPLOREMODE

새 찾아보기 창에 대한 폴더 트리를 지정합니다. 현재 브라우저가 찾아보기 개체 호출의 SBSP_EXPLOREMODE 일치하지 않으면 새 창이 열립니다.

SBSP_HELPMODE

지원되지 않습니다. 사용하지 마십시오.

SBSP_NOTRANSFERHIST

검색 기록을 새 창으로 전송하지 마세요.

다음 플래그는 pidl 매개 변수의 범주를 지정합니다.

SBSP_ABSOLUTE

데스크톱을 기준으로 하는 절대 PIDL입니다.

SBSP_RELATIVE

현재 폴더를 기준으로 하는 상대 PIDL입니다.

SBSP_PARENT

부모 폴더를 찾아보고 PIDL을 무시합니다.

SBSP_NAVIGATEBACK

다시 탐색하고 PIDL을 무시합니다.

SBSP_NAVIGATEFORWARD

앞으로 이동하여 PIDL을 무시합니다.

SBSP_ALLOW_AUTONAVIGATE(0x00010000)

자동 탐색을 사용하도록 설정합니다.

다음 플래그는 모드를 지정합니다.

SBSP_KEEPSAMETEMPLATE(0x00020000)

Windows Vista 이상. 지원되지 않습니다. 사용하지 마십시오.

SBSP_KEEPWORDWHEELTEXT(0x00040000)

Windows Vista 이상. 검색 항목 필드를 지우지 않고 탐색합니다.

SBSP_ACTIVATE_NOFOCUS(0x00080000)

Windows Vista 이상. 포커스를 새 보기로 설정하는 기본 동작 없이 탐색합니다.

다음 플래그는 탐색의 결과로 기록이 조작되는 방식을 제어합니다.

SBSP_CALLERUNTRUSTED(0x00800000)

Microsoft Internet Explorer 6 SP2(서비스 팩 2) 이상. 탐색은 로컬 시스템에 이미 있는 스크립팅 코드가 있는 웹 페이지에 의해 시작되었을 수 있습니다.

SBSP_TRUSTFIRSTDOWNLOAD(0x01000000)

Microsoft Internet Explorer 6 SP2(서비스 팩 2) 이상. 새 창은 사용자가 시작한 작업의 결과입니다. 콘텐츠를 즉시 다운로드하려고 하면 새 창을 신뢰합니다.

SBSP_UNTRUSTEDFORDOWNLOAD(0x02000000)

Microsoft Internet Explorer 6 SP2(서비스 팩 2) 이상. 창이 신뢰할 수 없는 HTML이 아닌 파일로 이동하고 있습니다. 사용자가 파일을 다운로드하려고 하면 다운로드를 허용하지 않습니다.

SBSP_NOAUTOSELECT

기록 창에서 선택 영역을 표시하지 않습니다.

SBSP_WRITENOHISTORY

기록 셸 폴더에 이 탐색 기록을 쓰지 않습니다.

SBSP_CREATENOHISTORY(0x00100000)

0x00100000. Windows 7 이상. 여행 로그에 새 항목을 추가하지 마세요. 사용자가 검색 상자에 검색어를 입력하고 쿼리를 구체화하면 브라우저가 앞으로 이동하지만 추가 이동 로그 항목은 추가하지 않습니다.

SBSP_TRUSTEDFORACTIVEX(0x10000000)

Microsoft Internet Explorer 6 SP2(서비스 팩 2) 이상. 탐색은 ActiveX 프롬프트를 허용해야 합니다.

SBSP_FEEDNAVIGATION(0x20000000)

Windows Internet Explorer 7 이상. 현재 레지스트리 설정에서 허용되는 경우 브라우저에 탐색할 대상을 지정합니다.

SBSP_REDIRECT(0x40000000)

다른 URL로 리디렉션할 수 있습니다.

SBSP_INITIATEDBYHLINKFRAME(0x80000000)

SBSP_PLAYNOSOUND(0x00200000)

Windows 7 이상. 검색 상자에서 각 키 입력에 대한 탐색을 완료하지 마세요.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

보기는 이 메서드를 사용하여 Windows Explorer 네임스페이스의 특정 위치로 이동하도록 강제할 수 있습니다. 일반적으로 보기에 포함된 폴더입니다.

예제

IShellBrowser* psb;
hr = IUnknown_QueryService(punkSite, SID_STopLevelBrowser, IID_PPV_ARGS(&psb));

if (SUCCEEDED(hr))
{
    hr = psb->BrowseObject(pidlSearch, SBSP_DEFBROWSER | SBSP_ABSOLUTE);
    psb->Release();
}

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.0 이상)

추가 정보

IShellBrowser