IQuickActivate::QuickActivate-Methode (ocidl.h)

Artikel
08/25/2023

Schnell aktiviert ein Steuerelement.

Syntax

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

Parameter

[in] pQaContainer

Ein Zeiger auf die QACONTAINER-Struktur , die Informationen zum Container enthält.

[in, out] pQaControl

Ein Zeiger auf die QACONTROL-Struktur , die vom Steuerelement ausgefüllt wird, um Informationen zum Steuerelement an den Container zurückzugeben. Der Container, der diese Methode aufruft, muss Arbeitsspeicher für diese Struktur reservieren.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird sie E_FAIL.

Hinweise

Wenn das Steuerelement IQuickActivate nicht unterstützt, führt der Container beim Laden des Steuerelements bestimmte Handshakingvorgänge aus. Der Container ruft bestimmte Schnittstellen auf dem Steuerelement auf, und das Steuerelement ruft wiederum bestimmte Schnittstellen am Clientstandort des Containers zurück. Zunächst erstellt der Container das Steuerelementobjekt und ruft QueryInterface auf, um die benötigten Schnittstellen abzufragen. Anschließend ruft der Container IOleObject::SetClientSite im Steuerelement auf und übergibt einen Zeiger auf den Clientstandort. Als Nächstes ruft das Steuerelement QueryInterface auf dieser Website auf und ruft einen Zeiger auf zusätzliche erforderliche Schnittstellen ab.

Mit der QuickActivate-Methode übergibt der Container einen Zeiger an eine QACONTAINER-Struktur . Die Struktur enthält Zeiger auf Schnittstellen, die vom Steuerelement benötigt werden, und die Werte einiger Umgebungseigenschaften, die das Steuerelement möglicherweise benötigt. Nach der Rückgabe übergibt das Steuerelement einen Zeiger an eine QACONTROL-Struktur, die Zeiger auf eigene Schnittstellen enthält, die der Container benötigt, und zusätzliche status Informationen.

Die Methoden IPersist*::Load und IPersist*::InitNew sollten aufgerufen werden, nachdem die schnelle Aktivierung erfolgt ist. Das Steuerelement sollte während der schnellen Aktivierung seine Verbindungen mit den Senken des Containers herstellen. Diese Verbindungen werden jedoch erst ausgeführt, wenn IPersist*::Load oder IPersist*::InitNew aufgerufen wurde.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h