La fonction AllocConsoleWithOptions

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 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

Voir aussi

Fonctions de console

Consoles

Stratégie d’allocation de console

AllocConsole

AttachConsole

FreeConsole