DeactivateActCtx-Funktion (winbase.h)

Artikel
08/27/2023

Die Funktion DeactivateActCtx deaktiviert den Aktivierungskontext, der dem angegebenen Cookie entspricht.

Syntax

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

Parameter

[in] dwFlags

Flags, die angeben, wie die Deaktivierung erfolgen soll.

Wert	Bedeutung
0	Wenn dieser Wert festgelegt ist und sich das im ulCookie-Parameter angegebene Cookie im oberen Frame des Aktivierungsstapels befindet, wird der Aktivierungskontext aus dem Stapel geknallt und dadurch deaktiviert. Wenn dieser Wert festgelegt ist und sich das im parameter ulCookie angegebene Cookie nicht im oberen Rahmen des Aktivierungsstapels befindet, durchsucht diese Funktion den Stapel nach dem Cookie. Wenn das Cookie gefunden wird, wird eine STATUS_SXS_EARLY_DEACTIVATION Ausnahme ausgelöst. Wenn das Cookie nicht gefunden wird, wird eine STATUS_SXS_INVALID_DEACTIVATION Ausnahme ausgelöst. Dieser Wert sollte in den meisten Fällen angegeben werden.
DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION	Wenn dieser Wert festgelegt ist und sich das im ulCookie-Parameter angegebene Cookie im oberen Frame des Aktivierungsstapels befindet, gibt die Funktion einen ERROR_INVALID_PARAMETER Fehlercode zurück. Rufen Sie GetLastError auf, um diesen Code abzurufen. Wenn dieser Wert festgelegt ist und sich das Cookie nicht im Aktivierungsstapel befindet, wird eine STATUS_SXS_INVALID_DEACTIVATION Ausnahme ausgelöst. Wenn dieser Wert festgelegt ist und sich das Cookie in einem niedrigeren Rahmen des Aktivierungsstapels befindet, werden alle Frames bis hin zu und einschließlich des Frames, in dem sich das Cookie befindet, aus dem Stapel geknallt.

Wert

Bedeutung

0

Wenn dieser Wert festgelegt ist und sich das im ulCookie-Parameter angegebene Cookie im oberen Frame des Aktivierungsstapels befindet, wird der Aktivierungskontext aus dem Stapel geknallt und dadurch deaktiviert.

Wenn dieser Wert festgelegt ist und sich das im parameter ulCookie angegebene Cookie nicht im oberen Rahmen des Aktivierungsstapels befindet, durchsucht diese Funktion den Stapel nach dem Cookie.

Wenn das Cookie gefunden wird, wird eine STATUS_SXS_EARLY_DEACTIVATION Ausnahme ausgelöst.

Wenn das Cookie nicht gefunden wird, wird eine STATUS_SXS_INVALID_DEACTIVATION Ausnahme ausgelöst.

Dieser Wert sollte in den meisten Fällen angegeben werden.

DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION

Wenn dieser Wert festgelegt ist und sich das im ulCookie-Parameter angegebene Cookie im oberen Frame des Aktivierungsstapels befindet, gibt die Funktion einen ERROR_INVALID_PARAMETER Fehlercode zurück. Rufen Sie GetLastError auf, um diesen Code abzurufen.

Wenn dieser Wert festgelegt ist und sich das Cookie nicht im Aktivierungsstapel befindet, wird eine STATUS_SXS_INVALID_DEACTIVATION Ausnahme ausgelöst.

Wenn dieser Wert festgelegt ist und sich das Cookie in einem niedrigeren Rahmen des Aktivierungsstapels befindet, werden alle Frames bis hin zu und einschließlich des Frames, in dem sich das Cookie befindet, aus dem Stapel geknallt.

[in] ulCookie

Die ULONG_PTR, die an den Aufruf von ActivateActCtx übergeben wurde. Dieser Wert wird als Cookie verwendet, um einen bestimmten aktivierten Aktivierungskontext zu identifizieren.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Diese Funktion legt Fehler fest, die durch Aufrufen von GetLastError abgerufen werden können. Ein Beispiel finden Sie unter Abrufen des Last-Error Codes. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Die Deaktivierung von Aktivierungskontexten muss in umgekehrter Reihenfolge der Aktivierung erfolgen. Es kann als Popping eines Aktivierungskontexts aus einem Stapel verstanden werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

ActivateActCtx

Share via