Fonction DeactivateActCtx (winbase.h)

Article
08/27/2023

La fonction DeactivateActCtx désactive le contexte d’activation correspondant au cookie spécifié.

Syntaxe

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

Paramètres

[in] dwFlags

Indicateurs qui indiquent comment la désactivation doit se produire.

Valeur	Signification
0	Si cette valeur est définie et que le cookie spécifié dans le paramètre ulCookie se trouve dans le cadre supérieur de la pile d’activation, le contexte d’activation est extrait de la pile et est ainsi désactivé. Si cette valeur est définie et que le cookie spécifié dans le paramètre ulCookie n’est pas dans le cadre supérieur de la pile d’activation, cette fonction recherche le cookie dans la pile. Si le cookie est trouvé, une exception STATUS_SXS_EARLY_DEACTIVATION est levée. Si le cookie est introuvable, une exception STATUS_SXS_INVALID_DEACTIVATION est levée. Cette valeur doit être spécifiée dans la plupart des cas.
DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION	Si cette valeur est définie et que le cookie spécifié dans le paramètre ulCookie se trouve dans le cadre supérieur de la pile d’activation, la fonction retourne un code d’erreur ERROR_INVALID_PARAMETER. Appelez GetLastError pour obtenir ce code. Si cette valeur est définie et que le cookie ne se trouve pas sur la pile d’activation, une exception STATUS_SXS_INVALID_DEACTIVATION est levée. Si cette valeur est définie et que le cookie se trouve dans une image inférieure de la pile d’activation, toutes les images jusqu’à et y compris le cadre dans lequel se trouve le cookie sont extraites de la pile.

Valeur

Signification

0

Si cette valeur est définie et que le cookie spécifié dans le paramètre ulCookie se trouve dans le cadre supérieur de la pile d’activation, le contexte d’activation est extrait de la pile et est ainsi désactivé.

Si cette valeur est définie et que le cookie spécifié dans le paramètre ulCookie n’est pas dans le cadre supérieur de la pile d’activation, cette fonction recherche le cookie dans la pile.

Si le cookie est trouvé, une exception STATUS_SXS_EARLY_DEACTIVATION est levée.

Si le cookie est introuvable, une exception STATUS_SXS_INVALID_DEACTIVATION est levée.

Cette valeur doit être spécifiée dans la plupart des cas.

DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION

Si cette valeur est définie et que le cookie spécifié dans le paramètre ulCookie se trouve dans le cadre supérieur de la pile d’activation, la fonction retourne un code d’erreur ERROR_INVALID_PARAMETER. Appelez GetLastError pour obtenir ce code.

Si cette valeur est définie et que le cookie ne se trouve pas sur la pile d’activation, une exception STATUS_SXS_INVALID_DEACTIVATION est levée.

Si cette valeur est définie et que le cookie se trouve dans une image inférieure de la pile d’activation, toutes les images jusqu’à et y compris le cadre dans lequel se trouve le cookie sont extraites de la pile.

[in] ulCookie

La ULONG_PTR passée à l’appel à ActivateActCtx. Cette valeur est utilisée en tant que cookie pour identifier un contexte d’activation activé spécifique.

Valeur retournée

Si la fonction réussit, elle retourne TRUE. Sinon, elle retourne FALSE.

Cette fonction définit les erreurs qui peuvent être récupérées en appelant GetLastError. Pour obtenir un exemple, consultez Récupération du code Last-Error. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système.

Remarques

La désactivation des contextes d’activation doit se produire dans l’ordre inverse de l’activation. Il peut être compris comme faisant éclater un contexte d’activation d’une pile.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

ActivateActCtx