IExplorerBrowser::BrowseToObject 메서드(shobjidl_core.h)

개체를 찾습니다.

구문

HRESULT BrowseToObject(
  [in] IUnknown *punk,
  [in] UINT     uFlags
);

매개 변수

[in] punk

형식: IUnknown*

탐색할 개체에 대한 포인터입니다. 개체를 검색할 수 없으면 오류 값이 반환됩니다.

[in] uFlags

형식: UINT

pidl의 범주를 지정하는 플래그입니다. 이는 탐색을 수행하는 방법에 영향을 줍니다. 값 0이거나 다음 값의 비트 조합이어야 합니다.

SBSP_ABSOLUTE

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

SBSP_RELATIVE

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

SBSP_PARENT

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

SBSP_NAVIGATEBACK

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

SBSP_NAVIGATEFORWARD

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

SBSP_KEEPWORDWHEELTEXT

Windows Vista 이상. 이 플래그는 새 위치의 항목이 이전 위치에서 필터링된 것과 동일한 방식으로 필터링되도록 WordWheel(Windows Explorer 검색 상자)에서 입력한 검색 텍스트를 이 탐색 중에 유지해야 함을 나타냅니다.

반환 값

형식: HRESULT

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

설명

uFlags는 탐색을 나타내는 플래그를 제외하고 EXPLORER_BROWSER_FILL_FLAGS 또는 BrowseObject의 wFlags 매개 변수에 정의된 플래그 중 일부가 될 수 있습니다.

이 메서드는 GetIDList 를 호출하고 반환된 pidl을 찾습니다. 펑크는NULL일 수 없다는 점을 제외하고 IExplorerBrowser::BrowseToIDList와 동일한 방식으로 작동합니다. 표준 사용법은 IShellFolder 또는 IShellItem을 검색하는 것입니다. 전달된 개체를 검색할 수 없는 경우 오류가 반환됩니다. 탐색할 수 있는 개체는 IPersistFolder2 또는 IPersistIDList를 구현합니다.

IExplorerBrowser의 첫 번째 탐색은 동기적입니다. 그 후에는 모든 탐색이 비동기식입니다. 따라서 보류 중인 탐색을 올바르게 설정하면 IExplorerBrowser::BrowseToObject 에 대한 호출이 성공하지만 탐색이 성공한다는 보장은 없습니다. 성공 및 실패에 대한 정보를 얻으려면 클라이언트는 IExplorerBrowserEvents 를 구현하고 OnNavigationComplete 및 OnNavigationFailed에서 적절하게 응답해야 합니다.

요구 사항