共用方式為


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*::LoadIPersist*::InitNew 方法。 控制項應該會在快速啟用期間建立其與容器接收的連線。 不過,在呼叫 IPersist*::LoadIPersist*::InitNew 之前,這些連線才會上線。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IPersistFile

IPersistStorage

IPersistStream

IPersistStreamInit

IQuickActivate