Fonction ActivateActCtx (winbase.h)

  • Article

La fonction ActivateActCtx active le contexte d’activation spécifié. Pour ce faire, il envoie (push) le contexte d’activation spécifié en haut de la pile d’activation. Le contexte d’activation spécifié est donc associé au thread actuel et à toutes les fonctions d’API côte à côte appropriées.

Syntaxe

BOOL ActivateActCtx(
  [in]  HANDLE    hActCtx,
  [out] ULONG_PTR *lpCookie
);

Paramètres

[in] hActCtx

Gérez vers une structure ACTCTX qui contient des informations sur le contexte d’activation à rendre actif.

[out] lpCookie

Pointeur vers un ULONG_PTR qui fonctionne comme un cookie, identifiant de manière unique 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

Le paramètre lpCookie est passé ultérieurement à DeactivateActCtx, qui vérifie l’association des appels à ActivateActCtx et DeactivateActCtx et garantit que le contexte d’activation approprié est désactivé. Cela est effectué, car la désactivation des contextes d’activation doit se produire dans l’ordre inverse de l’activation.

L’activation des contextes d’activation peut être comprise comme l’envoi (push) d’un contexte d’activation vers une pile de contextes d’activation. Le contexte d’activation que vous activez via cette fonction redirige toute liaison vers des DLL, des classes de fenêtres, des serveurs COM, des bibliothèques de types et des mutex pour toutes les API côte à côte que vous appelez.

L’élément supérieur d’une pile de contexte d’activation est le contexte d’activation par défaut actif du thread actuel. Si un handle de contexte d’activation Null est envoyé sur la pile, ce qui l’active, les paramètres par défaut du manifeste d’origine remplacent tous les contextes d’activation inférieurs à la pile.

Configuration requise

Condition requise Valeur
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

ACTCTX

DeactivateActCtx