Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
U kunt eventueel een nieuwe console toewijzen voor het aanroepende proces, terwijl u de zichtbaarheid van het nieuwe consolevenster kunt opgeven.
Syntaxis
HRESULT WINAPI AllocConsoleWithOptions(
_In_opt_ PALLOC_CONSOLE_OPTIONS allocOptions,
_Out_opt_ PALLOC_CONSOLE_RESULT result
);
Parameterwaarden
allocOptions [in, optioneel] Een ALLOC_CONSOLE_OPTIONS structuur die bepaalt hoe deze functie een venster toewijst.
resultaat [uit, optioneel] Ontvangt een van de volgende waarden:
| Waarde | Betekenis |
|---|---|
| ALLOC_CONSOLE_RESULT_NO_CONSOLE 0 | Er is geen console gemaakt, omdat ALLOC_CONSOLE_MODE_DEFAULT is gebruikt en het bovenliggende proces heeft gevraagd om geen console te maken. |
| ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1 | Er is een nieuwe consolesessie gemaakt als gevolg van deze aanroep. Het resulterende gedrag is identiek aan AllocConsole. |
| ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2 | Het proces is gekoppeld aan een bestaande consolesessie, geërfd door het bovenliggende proces. Het resulterende gedrag is identiek aan AttachConsole. |
Retourwaarde
Type: HRESULT
Als deze methode slaagt, wordt S_OKgeretourneerd. Anders wordt een HRESULT- foutcode geretourneerd.
Opmerkingen
In tegenstelling tot AllocConsole of AttachConsole, resulteert het aanroepen van deze methode wanneer deze al is verbonden met een consolesessie geen fout. In dat geval wordt de resultaatparameter ingesteld op ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE .
Een proces kan de functie FreeConsole gebruiken om zichzelf los te koppelen van de huidige console. Een console wordt gesloten wanneer het laatste proces dat eraan is gekoppeld, beëindigd wordt of FreeConsole wordt aangeroepen.
Behoeften
| Minimaal ondersteunde client | Windows 11 24H2 (build 26100) [alleen voor desktopapps] |
| Minimaal ondersteunde server | Windows Server 2025 (build 26100) |
| Koptekst | ConsoleApi.h (via WinCon.h, inclusief Windows.h) |
| Bibliotheek | Kernel32.lib |
| DLL | Kernel32.dll |