Funkcja AllocConsole

2025-07-09

Przydziela nową konsolę dla procesu wywoływania.

Składnia

BOOL WINAPI AllocConsole(void);

Parametry

Ta funkcja nie ma parametrów.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest niezerowa.

Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość to zero. Aby uzyskać rozszerzone informacje o błędzie, wywołaj metodę GetLastError.

Uwagi

Proces może być skojarzony tylko z jedną konsolą, więc funkcja AllocConsole kończy się niepowodzeniem, jeśli proces wywołujący ma już konsolę. Proces może użyć funkcji FreeConsole , aby odłączyć się od bieżącej konsoli, a następnie wywołać aplikację AllocConsole , aby utworzyć nową konsolę lub attachConsole w celu dołączenia do innej konsoli.

Jeśli proces wywołujący tworzy proces podrzędny, proces podrzędny dziedziczy nową konsolę.

AllocConsole inicjuje standardowe dane wejściowe, standardowe dane wyjściowe i standardowe uchwyty błędów dla nowej konsoli. Standardowy uchwyt wejściowy jest uchwytem do buforu wejściowego konsoli, a standardowy uchwyt wyjściowy i standardowy uchwyt błędu są uchwytami do bufora ekranu konsoli. Aby pobrać te uchwyty, użyj funkcji GetStdHandle.

Ta funkcja jest używana głównie przez aplikację graficznego interfejsu użytkownika (GUI) do tworzenia okna konsoli. Aplikacje graficznego interfejsu użytkownika są inicjowane bez konsoli. Aplikacje konsolowe są inicjowane za pomocą konsoli, chyba że są tworzone jako odłączone procesy (wywołując funkcję CreateProcess z flagą DETACHED_PROCESS ).

Wymagania


Minimalny obsługiwany klient	Windows 2000 Professional [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows 2000 Server [tylko aplikacje klasyczne]
Nagłówek	ConsoleApi.h (za pośrednictwem WinCon.h, zawierając Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel32.dll