IQuickActivate::Metode QuickActivate (ocidl.h)

Artikel
08/25/2023

Mengaktifkan kontrol dengan cepat.

Sintaks

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

Parameter

[in] pQaContainer

Penunjuk ke struktur QACONTAINER yang berisi informasi tentang kontainer.

[in, out] pQaControl

Penunjuk ke struktur QACONTROL yang diisi oleh kontrol untuk mengembalikan informasi tentang kontrol ke kontainer. Kontainer yang memanggil metode ini harus mencadangkan memori untuk struktur ini.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan S_OK. Jika tidak, itu E_FAIL.

Keterangan

Jika kontrol tidak mendukung IQuickActivate, kontainer melakukan operasi jabat tangan tertentu saat memuat kontrol. Kontainer memanggil antarmuka tertentu pada kontrol dan kontrol, pada gilirannya, memanggil kembali ke antarmuka tertentu di situs klien kontainer. Pertama, kontainer membuat objek kontrol dan memanggil QueryInterface untuk mengkueri antarmuka yang dibutuhkannya. Kemudian, kontainer memanggil IOleObject::SetClientSite pada kontrol, meneruskan penunjuk ke situs kliennya. Selanjutnya, kontrol memanggil QueryInterface di situs ini, mengambil penunjuk ke antarmuka tambahan yang diperlukan.

Menggunakan metode QuickActivate , kontainer meneruskan penunjuk ke struktur QACONTAINER . Struktur berisi pointer ke antarmuka yang diperlukan oleh kontrol dan nilai beberapa properti sekitar yang mungkin diperlukan kontrol. Setelah kembali, kontrol meneruskan pointer ke struktur QACONTROL yang berisi pointer ke antarmukanya sendiri yang diperlukan kontainer, dan informasi status tambahan.

Metode IPersist*::Load and IPersist*::InitNew harus dipanggil setelah aktivasi cepat terjadi. Kontrol harus membuat koneksinya ke sink kontainer selama aktivasi cepat. Namun, koneksi ini tidak aktif sampai IPersist*::Load atau IPersist*::InitNew telah dipanggil.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	ocidl.h