Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Alloue éventuellement une nouvelle console pour le processus d’appel, tout en vous permettant de spécifier la visibilité de la nouvelle fenêtre de console.
Syntaxe
HRESULT WINAPI AllocConsoleWithOptions(
_In_opt_ PALLOC_CONSOLE_OPTIONS allocOptions,
_Out_opt_ PALLOC_CONSOLE_RESULT result
);
Paramètres
allocOptions [in, facultatif] Structure ALLOC_CONSOLE_OPTIONS qui contrôle la façon dont cette fonction alloue une fenêtre.
result [out, optional] Reçoit l’une des valeurs suivantes :
| Valeur | Signification |
|---|---|
| ALLOC_CONSOLE_RESULT_NO_CONSOLE 0 | Aucune console n’a été créée, car ALLOC_CONSOLE_MODE_DEFAULT a été utilisé et le processus parent n’a demandé aucune création. |
| ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1 | Une nouvelle session de console a été créée suite à cet appel. Le comportement résultant est identique à AllocConsole. |
| ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2 | Le processus s’est attaché à une session de console existante, héritée par le processus parent. Le comportement résultant est identique à AttachConsole. |
Valeur retournée
Type : HRESULT
Si cette méthode aboutit, elle renvoie S_OK. Sinon, elle renvoie un code d’erreur HRESULT.
Remarques
Contrairement à AllocConsole ou AttachConsole, l’appel de cette méthode lorsqu’elle est déjà connectée à une session de console n’entraîne pas d’erreur. Le paramètre de résultat est défini sur ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE dans ce cas.
Un processus peut utiliser la fonction FreeConsole pour se détacher de sa console actuelle. Une console est fermée lorsque le dernier processus attaché à celui-ci se termine ou appelle FreeConsole.
Spécifications
| Client minimal pris en charge | Windows 11 24H2 (build 26100) [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2025 (build 26100) |
| En-tête de page | ConsoleApi.h (via WinCon.h, incluez Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |