CreateActCtxA, fonction (winbase.h)
La fonction CreateActCtx crée un contexte d’activation.
Syntaxe
HANDLE CreateActCtxA(
[in, out] PCACTCTXA pActCtx
);
Paramètres
[in, out] pActCtx
Pointeur vers une structure ACTCTX qui contient des informations sur le contexte d’activation à créer.
Valeur de retour
Si la fonction réussit, elle retourne un handle au contexte d’activation retourné. Sinon, elle retourne INVALID_HANDLE_VALUE.
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
Définissez les bits non définis dans dwFlags de ACTCTX sur 0. Si aucun bits non défini n’est défini sur 0, l’appel à CreateActCtx qui crée le contexte d’activation échoue et retourne un code d’erreur de paramètre non valide. Le handle retourné par CreateActCtx est passé dans un appel à ActivateActCtx pour activer le contexte du thread actif.
Note
L’en-tête winbase.h définit CreateActCtx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |