FreeConsole

[funkcja] Odłącza konsolę od aktualnego procesu.

Składnia

#include <windows.h>

BOOL WINAPI FreeConsole( void );

Zwracana wartość

Zwraca wartość różną od zera w przypadku sukcesu. W przeciwnym wypadku funkcja zwraca wartość 0.

Aby uzyskać rozszerzone informacje o błędzie, wywołaj funkcję _{» WinAPI ♦}GetLastError.

Opis szczegółowy

Proces może być podłączony maksymalnie do jednej konsoli. Jeżeli proces wywołujący niniejszą funkcję nie jest powiązany z konsolą to funkcja _{» WinAPI ♦}GetLastError zwróci kod błędu ERROR_INVALID_PARAMETER.

Dodatkowe informacje

Proces może użyć niniejszej funkcji w celu odłączenia od siebie konsoli. Jeżeli proces współdzieli konsolę to konsola nie zostanie zniszczona, ale proces nie będzie mógł już jej używać. Okno konsoli jest zamykane gdy ostatni podłączony proces do niej zostanie zakończony bądź wywoła funkcję FreeConsole. Proces, który wywołał funkcję FreeConsole może utworzyć nową konsolę za pomocą funkcji _{» WinAPI ♦}AllocConsole lub podłączyć się do istniejącej konsoli przy pomocy funkcji _{» WinAPI ♦}AttachConsole.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Biblioteka	Kernel32.lib
DLL	Kernel32.dll

Przykład

#include <windows.h>

int main()
{
if( FreeConsole() )
MessageBoxA( NULL, "Konsola została odłączona od procesu.", "Komunikat", MB_ICONEXCLAMATION );
else
MessageBoxA( NULL, "Odłączenie konsoli się nie powiodło.", "Komunikat", MB_ICONERROR );

return 0;
}

Zagadnienia powiązane

AllocConsole	Tworzy nową konsolę dla procesu. (funkcja)
AttachConsole	Podłącza się do istniejącej konsoli innego procesu. (funkcja)

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms683150(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.