Menonaktifkan fungsiActCtx (winbase.h)

Artikel
08/27/2023

Fungsi NonaktifkanActCtx menonaktifkan konteks aktivasi yang sesuai dengan cookie yang ditentukan.

Sintaks

BOOL DeactivateActCtx(
  [in] DWORD     dwFlags,
  [in] ULONG_PTR ulCookie
);

Parameter

[in] dwFlags

Bendera yang menunjukkan bagaimana pennonaktifkanan terjadi.

Nilai	Makna
0	Jika nilai ini diatur dan cookie yang ditentukan dalam parameter ulCookie berada di bingkai atas tumpukan aktivasi, konteks aktivasi muncul dari tumpukan dan dengan demikian dinonaktifkan. Jika nilai ini diatur dan cookie yang ditentukan dalam parameter ulCookie tidak berada di bingkai atas tumpukan aktivasi, fungsi ini mencari tumpukan untuk cookie. Jika cookie ditemukan, pengecualian STATUS_SXS_EARLY_DEACTIVATION akan dilemparkan. Jika cookie tidak ditemukan, pengecualian STATUS_SXS_INVALID_DEACTIVATION akan dilemparkan. Nilai ini harus ditentukan dalam banyak kasus.
DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION	Jika nilai ini diatur dan cookie yang ditentukan dalam parameter ulCookie berada di bingkai atas tumpukan aktivasi, fungsi mengembalikan kode kesalahan ERROR_INVALID_PARAMETER. Panggil GetLastError untuk mendapatkan kode ini. Jika nilai ini diatur dan cookie tidak ada di tumpukan aktivasi, pengecualian STATUS_SXS_INVALID_DEACTIVATION akan dilemparkan. Jika nilai ini diatur dan cookie berada dalam bingkai yang lebih rendah dari tumpukan aktivasi, semua bingkai turun ke dan termasuk bingkai tempat cookie dimunculkan dari tumpukan.

Nilai

Makna

0

Jika nilai ini diatur dan cookie yang ditentukan dalam parameter ulCookie berada di bingkai atas tumpukan aktivasi, konteks aktivasi muncul dari tumpukan dan dengan demikian dinonaktifkan.

Jika nilai ini diatur dan cookie yang ditentukan dalam parameter ulCookie tidak berada di bingkai atas tumpukan aktivasi, fungsi ini mencari tumpukan untuk cookie.

Jika cookie ditemukan, pengecualian STATUS_SXS_EARLY_DEACTIVATION akan dilemparkan.

Jika cookie tidak ditemukan, pengecualian STATUS_SXS_INVALID_DEACTIVATION akan dilemparkan.

Nilai ini harus ditentukan dalam banyak kasus.

DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION

Jika nilai ini diatur dan cookie yang ditentukan dalam parameter ulCookie berada di bingkai atas tumpukan aktivasi, fungsi mengembalikan kode kesalahan ERROR_INVALID_PARAMETER. Panggil GetLastError untuk mendapatkan kode ini.

Jika nilai ini diatur dan cookie tidak ada di tumpukan aktivasi, pengecualian STATUS_SXS_INVALID_DEACTIVATION akan dilemparkan.

Jika nilai ini diatur dan cookie berada dalam bingkai yang lebih rendah dari tumpukan aktivasi, semua bingkai turun ke dan termasuk bingkai tempat cookie dimunculkan dari tumpukan.

[in] ulCookie

ULONG_PTR yang diteruskan ke panggilan ke ActivateActCtx. Nilai ini digunakan sebagai cookie untuk mengidentifikasi konteks aktivasi tertentu yang diaktifkan.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TRUE. Jika tidak, ia mengembalikan FALSE.

Fungsi ini mengatur kesalahan yang dapat diambil dengan memanggil GetLastError. Misalnya, lihat Mengambil Kode Last-Error. Untuk daftar lengkap kode kesalahan, lihat Kode Kesalahan Sistem.

Keterangan

Pennonaktifkan konteks aktivasi harus terjadi dalam urutan aktivasi terbalik. Ini dapat dipahami sebagai memunculkan konteks aktivasi dari tumpukan.

Persyaratan


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

AktifkanActCtx

Bagikan melalui