Udostępnij przez

Funkcja AllocConsoleWithOptions

Opcjonalnie przydziela nową konsolę dla procesu wywoływania, umożliwiając jednocześnie określenie widoczności nowego okna konsoli.

Składnia

HRESULT WINAPI AllocConsoleWithOptions(
    _In_opt_  PALLOC_CONSOLE_OPTIONS allocOptions,
    _Out_opt_ PALLOC_CONSOLE_RESULT  result
);

Parametry

allocOptions [in, opcjonalnie] Struktura ALLOC_CONSOLE_OPTIONS , która kontroluje sposób przydzielania okna przez tę funkcję.

result [out, optional] Odbiera jedną z następujących wartości:

Wartość Znaczenie
ALLOC_CONSOLE_RESULT_NO_CONSOLE 0 Nie utworzono żadnej konsoli, ponieważ użyto ALLOC_CONSOLE_MODE_DEFAULT, a proces nadrzędny zażądał, aby żadna nie została utworzona.
ALLOC_CONSOLE_RESULT_NOWA_KONSOLA 1 W wyniku tego wywołania została utworzona nowa sesja konsoli. Wynikowe zachowanie jest identyczne z allocConsole.
ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2 Proces został dołączony do istniejącej sesji konsoli dziedziczonej przez proces nadrzędny. Wynikowe zachowanie jest identyczne z elementem AttachConsole.

Wartość zwracana

Typ: HRESULT

Jeśli ta metoda powiedzie się, zwraca S_OK. W przeciwnym razie zwraca kod błędu HRESULT.

Uwagi

W przeciwieństwie do elementu AllocConsole lub AttachConsole wywołanie tej metody, gdy jest już połączone z sesją konsoli, nie powoduje błędu. Parametr result zostanie ustawiony na ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE w tym przypadku.

Proces może użyć funkcji FreeConsole , aby odłączyć się od bieżącej konsoli. Konsola jest zamykana po zakończeniu ostatniego dołączonego procesu lub wywołaniu FreeConsole.

Wymagania

   
Minimalny obsługiwany klient Windows 11 24H2 (kompilacja 26100) [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer Windows Server 2025 (kompilacja 26100)
Nagłówek ConsoleApi.h (za pośrednictwem pliku WinCon.h, zawiera Windows.h)
Biblioteka Kernel32.lib
DLL Kernel32.dll

Zobacz także

Funkcje konsoli

Konsole

Zasady alokacji konsoli

AllocConsole

AttachConsole

FreeConsole

  • Last updated on