Share via

IShellWindows::FindWindowSW 메서드(exdisp.h)

  • 아티클

Shell 창 컬렉션에서 창을 찾아 창의 핸들 및 IDispatch 인터페이스를 반환합니다.

구문

HRESULT FindWindowSW(
  [in]          VARIANT   *pvarLoc,
  [in]          VARIANT   *pvarLocRoot,
  [in]          int       swClass,
  [out]         long      *phwnd,
                int       swfwOptions,
  [out, retval] IDispatch **ppdispOut
);

매개 변수

[in] pvarLoc

형식: VARIANT*

형식의 VARIANT VT_VARIANT | VT_BYREF. pvarLoc 값을 찾을 창을 지정하는 절대 PIDL(PIDLIST_ABSOLUTE)으로 설정합니다. (설명을 참조하세요.)

[in] pvarLocRoot

형식: VARIANT*

NULL이거나 VT_EMPTY 형식이어야 합니다.

[in] swClass

형식: int

검색에 포함할 창 유형을 지정하는 하나 이상의 ShellWindowTypeConstants 플래그입니다.

[out] phwnd

형식: long*

지정된 검색 조건과 일치하는 창에 대한 핸들이거나, 해당 창을 찾을 수 없는 경우 NULL 입니다.

swfwOptions

형식: int

검색 옵션을 지정하는 하나 이상의 ShellWindowFindWindowOptions 플래그입니다.

[out, retval] ppdispOut

형식: IDispatch**

창의 IDispatch 인터페이스에 대한 참조이거나, 해당 창이 없는 경우 NULL 입니다.

반환 값

형식: HRESULT

다음 값 또는 표준 결과 코드 중 하나입니다.

반환 코드 Description
S_OK
 지정된 검색 조건과 일치하는 창이 발견되었습니다.
S_FALSE
 지정된 검색 조건과 일치하는 창을 찾을 수 없습니다.
E_NOINTERFACE
 창을 찾았지만 창의 IDispatch 인터페이스에 대한 참조를 가져올 수 없습니다. SWFO_NEEDDISPATCH 플래그가 설정된 경우에만 발생합니다.
E_PENDING
 창이 발견되었지만 창이 열려 있습니다. SWFO_INCLUDEPENDING 플래그가 설정된 경우에만 발생합니다.

설명

SWFO_COOKIEPASSED 플래그가 설정된 경우 pvarLoc은 PIDL 대신 쿠키로 해석됩니다.

요구 사항

   
대상 플랫폼 Windows
헤더 exdisp.h
DLL Shdocvw.dll(버전 5.00.2014.0216 이상)