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

Lihat juga

ACTCTX

NonaktifkanActCtx