Metodo IQuickActivate::QuickActivate (ocidl.h)

Articolo
08/25/2023

Attiva rapidamente un controllo.

Sintassi

HRESULT QuickActivate(
  [in]      QACONTAINER *pQaContainer,
  [in, out] QACONTROL   *pQaControl
);

Parametri

[in] pQaContainer

Puntatore alla struttura QACONTAINER contenente informazioni sul contenitore.

[in, out] pQaControl

Puntatore alla struttura QACONTROL compilata dal controllo per restituire informazioni sul controllo al contenitore. Il contenitore che chiama questo metodo deve riservare memoria per questa struttura.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, è E_FAIL.

Commenti

Se il controllo non supporta IQuickActivate, il contenitore esegue alcune operazioni di handshaking quando carica il controllo. Il contenitore chiama determinate interfacce sul controllo e il controllo, a sua volta, richiama a determinate interfacce nel sito client del contenitore. Prima di tutto, il contenitore crea l'oggetto controllo e chiama QueryInterface per eseguire query per le interfacce necessarie. Il contenitore chiama quindi IOleObject::SetClientSite nel controllo, passando un puntatore al sito client. Successivamente, il controllo chiama QueryInterface in questo sito, recuperando un puntatore a interfacce necessarie aggiuntive.

Usando il metodo QuickActivate , il contenitore passa un puntatore a una struttura QACONTAINER . La struttura contiene puntatori alle interfacce necessarie per il controllo e i valori di alcune proprietà di ambiente necessarie per il controllo. Al ritorno, il controllo passa un puntatore a una struttura QACONTROL che contiene puntatori alle proprie interfacce richieste dal contenitore e informazioni di stato aggiuntive.

IPersist*::Load e IPersist*::InitNew devono essere chiamati dopo l'attivazione rapida. Il controllo deve stabilire le connessioni ai sink del contenitore durante l'attivazione rapida. Tuttavia, queste connessioni non sono attive finché non è stato chiamato IPersist*::Load o IPersist*::InitNew.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

Condividi tramite