Función AllocConsoleWithOptions

Opcionalmente, asigna una nueva consola para el proceso de llamada, al tiempo que le permite especificar la visibilidad de la nueva ventana de consola.

Sintaxis

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

Parámetros

allocOptions [in, optional] Una estructura de ALLOC_CONSOLE_OPTIONS que controla cómo esta función asigna una ventana.

result [out, optional] Recibe uno de los siguientes valores:

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

A diferencia de AllocConsole o AttachConsole, llamar a este método cuando ya está conectado a una sesión de consola no produce un error. El parámetro result se establecerá en ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE en ese caso.

Un proceso puede usar la función FreeConsole para separarse de su consola actual. Se cierra una consola cuando el último proceso adjunto finaliza o llama a FreeConsole.

Requisitos

Consulte también

Funciones de consola

Consolas

Directiva de asignación de consola

AllocConsole

AttachConsole

FreeConsole