IQuickActivate::QuickActivate 方法 (ocidl.h)
快速啟動控制項。
語法
HRESULT QuickActivate(
[in] QACONTAINER *pQaContainer,
[in, out] QACONTROL *pQaControl
);
參數
[in] pQaContainer
QACONTAINER結構的指標,其中包含容器的相關資訊。
[in, out] pQaControl
控制項填入 QACONTROL 結構的指標,以將控制項的相關資訊傳回至容器。 呼叫這個方法的容器必須保留這個結構的記憶體。
傳回值
如果方法成功,傳回值會S_OK。 否則,它會E_FAIL。
備註
如果控制項不支援 IQuickActivate,容器會在載入控制項時執行特定的交握作業。 容器會呼叫控制項上的特定介面,而控制項接著會呼叫容器用戶端網站上的特定介面。 首先,容器會建立控制項物件,並呼叫 QueryInterface 來查詢所需的介面。 然後,容器會在控制項上呼叫 IOleObject::SetClientSite ,並將指標傳遞至其用戶端月臺。 接下來,控制項會在此網站上呼叫 QueryInterface ,並擷取其他必要介面的指標。
使用 QuickActivate 方法,容器會將指標傳遞至 QACONTAINER 結構。 結構包含控制項所需的介面指標,以及控制項可能需要之某些環境屬性的值。 傳回時,控制項會將指標傳遞至 QACONTROL 結構,其中包含容器所需的專屬介面指標,以及其他狀態資訊。
在快速啟用之後,應該呼叫 IPersist*::Load 和 IPersist*::InitNew 方法。 控制項應該會在快速啟用期間建立其與容器接收的連線。 不過,在呼叫 IPersist*::Load 或 IPersist*::InitNew 之前,這些連線才會上線。
需求
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |