функция IUnknown_GetWindow (shlwapi.h)

  • Статья

Пытается получить дескриптор окна из объекта COM, запрашивая различные интерфейсы с методом GetWindow .

Синтаксис

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

Параметры

[in] punk

Тип: IUnknown*

Указатель на COM-объект, из которого эта функция попытается получить дескриптор окна.

[out] phwnd

Тип: HWND*

Указатель на HWND, который при успешном возврате этой функции получает дескриптор окна. Если дескриптор окна не был получен, для этого параметра устанавливается значение NULL.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK, если дескриптор окна был успешно возвращен, или код ошибки COM в противном случае. Если подходящий интерфейс не найден, функция возвращает E_NOINTERFACE. В противном случае функция возвращает HRESULT , возвращенный методом GetWindow соответствующего интерфейса.

Комментарии

Эта функция пытается получить дескриптор окна путем вызова IOleWindow::GetWindow, IInternetSecurityMgrSite::GetWindow и IShellView::GetWindow. Возможно, что будущие версии IUnknown_GetWindow могут попытаться использовать дополнительные интерфейсы.

Примечание Запрос для IShellView теоретически не нужен, так как IShellView является производным от IOleWindow. Функция явно запрашивает этот интерфейс, так как некоторые объекты реализуют QueryInterface неправильно и не отвечают на запрос базового интерфейса.
 

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server, Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
DLL Shlwapi.dll (версия 5.0 или более поздняя)