IUnknown_GetWindow 함수(shlwapi.h)

GetWindow 메서드가 있는 다양한 인터페이스를 쿼리하여 COM(Component Object Model) 개체에서 창 핸들을 검색하려고 시도합니다.

구문

LWSTDAPI IUnknown_GetWindow(
  [in]  IUnknown *punk,
  [out] HWND     *phwnd
);

매개 변수

[in] punk

형식: IUnknown*

이 함수가 창 핸들을 가져오려고 시도하는 COM 개체에 대한 포인터입니다.

[out] phwnd

형식: HWND*

이 함수가 성공적으로 반환될 때 창 핸들을 수신하는 HWND에 대한 포인터입니다. 창 핸들을 가져오지 않은 경우 이 매개 변수는 NULL로 설정됩니다.

반환 값

형식: HRESULT

창 핸들이 성공적으로 반환되었거나 COM 오류 코드가 반환되면 S_OK 반환합니다. 적합한 인터페이스가 없으면 함수는 E_NOINTERFACE 반환합니다. 그렇지 않으면 함수는 해당 인터페이스의 GetWindow 메서드에서 반환된 HRESULT를 반환합니다.

설명

이 함수는 IOleWindow::GetWindow, IInternetSecurityMgrSite::GetWindow 및 IShellView::GetWindow를 호출하여 창 핸들을 검색하려고 시도합니다. 향후 버전의 IUnknown_GetWindow 추가 인터페이스를 시도할 수 있습니다.

참고IShellView는 IOleWindow에서 파생되므로 IShellView에 대한 쿼리는 이론적으로 불필요합니다. 일부 개체가 QueryInterface 를 잘못 구현하고 기본 인터페이스에 대한 쿼리에 응답하지 못하기 때문에 함수는 이 인터페이스를 명시적으로 쿼리합니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server, Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
DLL	Shlwapi.dll(버전 5.0 이상)