Fonction ActivateActCtx (winbase.h)
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 |