IExplorerBrowser::Advise 메서드(shobjidl_core.h)
이벤트 콜백에 대해 IExplorerBrowser 와의 연결을 시작합니다.
구문
HRESULT Advise(
[in] IExplorerBrowserEvents *psbe,
[out] DWORD *pdwCookie
);
매개 변수
[in] psbe
IExplorerBrowser 이벤트에 대해 알 수 있도록 개체의 IExplorerBrowserEvents 인터페이스에 대한 포인터입니다.
[out] pdwCookie
형식: DWORD*
이 메서드가 반환되면 에는 이벤트 수신기를 고유하게 식별하는 토큰이 포함됩니다. 이렇게 하면 여러 이벤트 수신기를 한 번에 구독할 수 있습니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 메서드는 IExplorerBrowserEvents의 구현자에 의해 호출됩니다. 구현자(수신기)는 IExplorerBrowserEvents 메서드의 콜백을 통해 ExplorerBrowser 보기 및 탐색 이벤트를 사용하는 것이 좋습니다.
첫 번째 IExplorerBrowser 탐색 전에 IExplorerBrowser::Advise를 호출하여 권고 연결을 시작합니다. 이벤트 수신기에 대한 콜백은 브라우저가 검색할 때 만들어집니다.
첫 번째 찾아보기는 IExplorerBrowser::BrowseToObject 또는 유사한 메서드의 호출에 동기적으로 발생합니다. 이후 콜백은 브라우저가 검색할 때 비동기적으로 발생합니다.
연결이 더 이상 필요하지 않으면 IExplorerBrowser::Unadvise 메서드를 호출하여 연결을 종료합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shobjidl_core.h(Shobjidl.h 포함) |