Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Optional weist eine neue Konsole für den Aufrufvorgang zu, während Sie die Sichtbarkeit des neuen Konsolenfensters angeben können.
Syntax
HRESULT WINAPI AllocConsoleWithOptions(
_In_opt_ PALLOC_CONSOLE_OPTIONS allocOptions,
_Out_opt_ PALLOC_CONSOLE_RESULT result
);
Parameter
allocOptions [in, optional] Eine ALLOC_CONSOLE_OPTIONS Struktur, die steuert, wie diese Funktion ein Fenster zuweist.
Ergebnis [out, optional] Empfängt einen der folgenden Werte:
| value | Bedeutung |
|---|---|
| ALLOC_CONSOLE_RESULT_NO_CONSOLE 0 | Es wurde keine Konsole erstellt, da ALLOC_CONSOLE_MODE_DEFAULT verwendet wurde und der übergeordnete Prozess aufgefordert wurde, keine zu erstellen. |
| ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1 | Als Ergebnis dieses Aufrufs wurde eine neue Konsolensitzung erstellt. Das resultierende Verhalten ist identisch mit AllocConsole. |
| ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2 | Der Prozess hat sich an eine bestehende Konsolensitzung angehängt, die vom Elternprozess geerbt wurde. Das resultierende Verhalten ist identisch mit AttachConsole. |
Rückgabewert
Type: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Bemerkungen
Im Gegensatz zu AllocConsole oder AttachConsole führt das Aufrufen dieser Methode, wenn sie bereits mit einer Konsolensitzung verbunden ist, nicht zu einem Fehler. Der Parameter Ergebnis wird gesetzt auf ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE in diesem Fall.
Ein Prozess kann die FreeConsole-Funktion verwenden, um sich von der aktuellen Konsole zu trennen. Eine Konsole wird geschlossen, wenn der letzte an sie angefügte Prozess beendet oder FreeConsole aufruft.
Anforderungen
| Mindest unterstützter Client | Windows 11 24H2 (Build 26100) [nur Desktop-Apps] |
| Unterstützter Mindestserver | Windows Server 2025 (Build 26100) |
| Kopfzeile | ConsoleApi.h (über WinCon.h, Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |