IOleInPlaceSite：：GetWindowCoNtext 方法 (oleidl.h)

可讓就地物件擷取形成視窗物件階層的視窗介面，以及物件就地啟用視窗應位於的父視窗位置。

語法

HRESULT GetWindowContext(
  [out]     IOleInPlaceFrame      **ppFrame,
  [out]     IOleInPlaceUIWindow   **ppDoc,
  [out]     LPRECT                lprcPosRect,
  [out]     LPRECT                lprcClipRect,
  [in, out] LPOLEINPLACEFRAMEINFO lpFrameInfo
);

參數

[out] ppFrame

IOleInPlaceFrame指標變數的指標，可接收框架的介面指標。 如果發生錯誤，實作必須將 ppFrame 設定為 Null。

[out] ppDoc

IOleInPlaceUIWindow指標變數的指標，可接收文件視窗的介面指標。 如果文件視窗與框架視窗相同， ppDoc 會設定為 Null。 在此情況下，物件只能使用 ppFrame 或框線交涉。 如果傳回錯誤，實作必須將 ppDoc 設定為 Null。

[out] lprcPosRect

矩形的 RECT 結構的指標，其中包含其父視窗之用戶端座標中就地物件的位置。 如果傳回錯誤，此參數必須設定為 Null。

[out] lprcClipRect

外部矩形的 RECT 結構的指標，其中包含就地物件的位置矩形 (lprcPosRect) 。 這個矩形相對於物件父視窗的工作區。 如果傳回錯誤，此參數必須設定為 Null。

[in, out] lpFrameInfo

容器要填入適當資料的 OLEINPLACEFRAMEINFO 結構的指標。 如果傳回錯誤，此參數必須設定為 Null。

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼	描述
E_INVALIDARG	提供的一或多個指標無效。
E_UNEXPECTED	已發生未預期的錯誤。

備註

OLEINPLACEFRAMEINFO結構提供 OLE 所需的資料，以在物件就地使用時，將按鍵快速鍵分派至容器框架。

啟始物件時，它會從其容器呼叫 GetWindowCoNtext 。 容器會透過 OLEINPLACEFRAMEINFO 結構，將控制碼傳回至其就地快速鍵資料表。 呼叫GetWindowCoNtext之前，物件必須填入lpFrameInfo所指向的 cb 成員，以提供OLEINPLACEFRAMEINFO結構的大小。

需求

最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	oleidl.h

另請參閱

IOleInPlaceSite