DeactivateActCtx-Funktion (winbase.h)
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 |
|---|---|
|
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. |
|
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 |