Returns the window handle to one of the windows participating in in-place activation (frame, document, parent, or in-place object window).
HRESULT GetWindow(
HWND * phwnd //Pointer to where to return window handle
);
This method supports the standard return values E_FAIL, E_OUTOFMEMORY, E_INVALIDARG, and E_UNEXPECTED, as well as the following:
Note For windowless objects, this method should always fail and return E_FAIL.
Five types of windows comprise the windows hierarchy. When a object is active in place, it has access to some or all of these windows:
| Window | Description |
|---|---|
| Frame | The outermost main window where the container application's main menu resides. |
| Document | The window that displays the compound document containing the embedded object to the user. |
| Pane | The subwindow of the document window that contains the object's view. Applicable only for applications with split-pane windows. |
| Parent | The container window that contains that object's view. The object application installs its window as a child of this window. |
| In-place | The window containing the active in-place object. The object application creates this window and installs it as a child of its hatch window, which is a child of the container's parent window. |
Each type of window has a different role in the in-place activation architecture. However, it is not necessary to employ a separate physical window for each type. Many container applications use the same window for their frame, document, pane, and parent windows.
Windows NT: Use version 3.1 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in oleidl.h.