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.
Arrête et libère les ressources associées à la pseudoconsole donnée.
Syntaxe
void WINAPI ClosePseudoConsole(
_In_ HPCON hPC
);
Paramètres
hPC [in]
Une poignée vers une pseudoconsole active telle qu’ouverte par CreatePseudoConsole.
Valeur retournée
aucune
Remarques
La fermeture d’une pseudoconsole envoie CTRL_CLOSE_EVENT à chaque application cliente qui est toujours connectée. Tant que les applications ne sont pas déconnectées, elles peuvent continuer à écrire davantage de données. En raison de cela, votre application est censée fermer le canal de sortie avant d’appeler ClosePseudoConsole ou de continuer la lecture à partir du canal jusqu’à ce que ClosePseudoConsole ait retourné.
Remarque
À compter de Windows 11 24H2 (build 26100), ClosePseudoConsole retourne immédiatement pour éviter les blocages accidentels. Les versions antérieures attendent indéfiniment la sortie du pseudoconsole. Si vous devez savoir quand tous les clients se sont déconnectés, continuez simplement à lire à partir du canal de sortie jusqu’à ce qu’il soit fermé sur vous.
Avertissement
Par conséquent, le fait de ne pas fermer ou drainer le canal de sortie peut entraîner ClosePseudoConsole à attendre indéfiniment dans les versions antérieures de Windows. Pour éviter les blocages sur les versions antérieures, n’appelez pas ClosePseudoConsole sur le même thread que celui à partir duquel vous lisez le canal de sortie, sauf si le canal de sortie a été précédemment fermé par vous ou fermé sur vous par le pseudoconsole.
Spécifications
| Client minimal pris en charge | Mise à jour d’octobre 2018 de Windows 10 (version 1809) [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2019 [applications de bureau uniquement] |
| En-tête de page | ConsoleApi.h (via WinCon.h, incluez Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |