ClosePseudoConsole işlevi

Belirtilen bir psödokonsol ile ilişkili kaynakları kapatır ve serbest bırakır.

Sözdizimi

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parametreler

hPC [inç]
CreatePseudoConsole tarafından açılan etkin bir "pseudoconsole" tanıtıcısı.

Dönüş değeri

hiç kimse

Açıklamalar

Pseudokonsol kapatılırsa, hala bağlı olan her istemci uygulamasına CTRL_CLOSE_EVENT gönderilir. Uygulamaların bağlantısı kesilene kadar daha fazla çıkış yazmaya devam edebilir. Bu nedenle uygulamanızın ClosePseudoConsole çağrısından önce çıkış kanalını kapatması veya ClosePseudoConsole döndürülene kadar kanaldan okumaya devam etmesi beklenir.

Uyarı

Windows 11 24H2'den (build 26100) itibaren ClosePseudoConsole kazara kilitlenmeleri önlemek için anında dönecek. Önceki sürümler, sözdekonsoleden çıkmak için süresiz olarak bekler. Tüm istemcilerin bağlantısının ne zaman kesildiğini bilmeniz gerekiyorsa, sizin için kapatılana kadar çıkış kanalından okumaya devam etmeniz yeterlidir.

Uyarı

Yukarıdakilerin bir sonucu olarak, çıkış kanalının kapatılamaması veya boşaltılamaması , ClosePseudoConsole'un Windows'un önceki sürümlerinde süresiz olarak beklemesine neden olabilir. Eski sürümlerde kilitlenmeleri önlemek için, çıkış kanalını okuduğunuz iş parçacığında ClosePseudoConsole fonksiyonunu çağırmayın; çıkış kanalı, ya sizin tarafınızdan ya da yazılım tabanlı konsol tarafından daha önce kapatılmadıysa.

Gereksinimler

Desteklenen en düşük düzeydeki istemci	Windows 10 Ekim 2018 Güncelleştirmesi (sürüm 1809) [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu	Windows Server 2019 [yalnızca masaüstü uygulamaları]
Başlık	ConsoleApi.h (WinCon.h aracılığıyla Windows.h'yi dahil edin)
Kütüphane	Kernel32.lib
DLL	Kernel32.dll

Ayrıca bakınız

Pseudoconsoles

CreatePseudoConsole

ResizePseudoConsole