Fungsi ActivateActCtx (winbase.h)
Fungsi ActivateActCtx mengaktifkan konteks aktivasi yang ditentukan. Ini dilakukan dengan mendorong konteks aktivasi yang ditentukan ke bagian atas tumpukan aktivasi. Konteks aktivasi yang ditentukan dengan demikian dikaitkan dengan utas saat ini dan fungsi API berdampingan yang sesuai.
Sintaks
BOOL ActivateActCtx(
[in] HANDLE hActCtx,
[out] ULONG_PTR *lpCookie
);
Parameter
[in] hActCtx
Tangani ke struktur ACTCTX yang berisi informasi tentang konteks aktivasi yang akan dibuat aktif.
[out] lpCookie
Arahkan ke ULONG_PTR yang berfungsi sebagai cookie, secara unik mengidentifikasi konteks aktivasi tertentu yang diaktifkan.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan TRUE. Jika tidak, ia mengembalikan FALSE.
Fungsi ini menetapkan kesalahan yang dapat diambil dengan memanggil GetLastError. Misalnya, lihat Mengambil Kode Last-Error. Untuk daftar lengkap kode kesalahan, lihat Kode Kesalahan Sistem.
Keterangan
Parameter lpCookie kemudian diteruskan ke DeactivateActCtx, yang memverifikasi pemasangan panggilan ke ActivateActCtx dan DeactivateActCtx dan memastikan bahwa konteks aktivasi yang sesuai sedang dinonaktifkan. Hal ini dilakukan karena pennonaktifkan konteks aktivasi harus terjadi dalam urutan aktivasi terbalik.
Aktivasi konteks aktivasi dapat dipahami sebagai mendorong konteks aktivasi ke tumpukan konteks aktivasi. Konteks aktivasi yang Anda aktifkan melalui fungsi ini mengalihkan pengikatan apa pun ke DLL, kelas jendela, server COM, pustaka jenis, dan mutex untuk API berdampingan yang Anda panggil.
Item atas tumpukan konteks aktivasi adalah konteks aktif dan aktivasi default dari utas saat ini. Jika handel konteks aktivasi null didorong ke tumpukan, sehingga mengaktifkannya, pengaturan default dalam manifes asli mengambil alih semua konteks aktivasi yang lebih rendah pada tumpukan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winbase.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |