_cwait
Espera hasta que finaliza otro proceso.
Importante
Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas en aplicaciones de la Plataforma universal de Windows.
Sintaxis
intptr_t _cwait(
int *termstat,
intptr_t procHandle,
int action
);
Parámetros
termstat
Puntero a un búfer en el que se almacenará el código de resultado del proceso especificado, o NULL.
procHandle
Identificador del proceso al que se va a esperar (es decir, el proceso que tiene que finalizar antes de que _cwait pueda devolver un valor).
action
procHandle: las aplicaciones el sistema operativo Windows lo omiten; en el caso de otras aplicaciones: código de acción que se va a realizar en NULL.
Valor devuelto
Cuando el proceso especificado finaliza correctamente, devuelve el identificador del proceso especificado y establece termstat en el código de resultado devuelto por el proceso especificado. De lo contrario, devuelve –1 y establece errno como se indica a continuación.
Valor de errno |
Descripción |
|---|---|
ECHILD |
No existe ningún proceso especificado, procHandle no es válido o la llamada a la API GetExitCodeProcess o WaitForSingleObject ha generado errores. |
EINVAL |
action no es válido. |
Para obtener más información sobre estos y otros códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.
Comentarios
La función _cwait espera a que finalice el proceso de identificación de proceso proporcionado por procHandle para el proceso especificado. El valor de procHandle que se pasa a _cwait debe ser el valor devuelto por la llamada a la función _spawn que ha creado el proceso especificado. Si el identificador de proceso finaliza antes de que se llame a _cwait, _cwait devuelve un valor inmediatamente. _cwait se puede usar en cualquier proceso para esperar a cualquier otro proceso conocido para el que existe un identificador válido (procHandle).
termstat señala a un búfer en el que se almacenará el código devuelto del proceso especificado. El valor de termstat indica si el proceso especificado ha finalizado con normalidad mediante una llamada a la API ExitProcess de Windows. Se llama internamente a ExitProcess si el proceso especificado llama a exit o _exit, vuelve desde main o llega al final de main. Para obtener más información sobre el valor que se pasa a través termstatde , vea GetExitCodeProcess. Si se llama a _cwait con un valor NULL para termstat, el código de retorno del proceso especificado no se almacena.
El sistema operativo Windows omite el parámetro action, porque en estos entornos no están implementadas las relaciones principal-secundario.
A menos que procHandle sea -1 o -2 (identificadores del proceso o subproceso actual), el identificador se cierra. En esta situación, no use el identificador devuelto.
De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.
Requisitos
| Routine | Encabezado necesario | Encabezado opcional |
|---|---|---|
_cwait |
<process.h> | <errno.h> |
Para obtener más información sobre compatibilidad, consulte Compatibilidad.
Ejemplo
// crt_cwait.c
// compile with: /c
// This program launches several processes and waits
// for a specified process to finish.
#define _CRT_RAND_S
#include <windows.h>
#include <process.h>
#include <stdlib.h>
#include <stdio.h>
#include <time.h>
// Macro to get a random integer within a specified range
#define getrandom( min, max ) (( (rand_s (&number), number) % (int)((( max ) + 1 ) - ( min ))) + ( min ))
struct PROCESS
{
intptr_t hProcess;
char name[40];
} process[4] = { { 0, "Ann" }, { 0, "Beth" }, { 0, "Carl" }, { 0, "Dave" } };
int main(int argc, char* argv[])
{
int termstat, c;
unsigned int number;
srand((unsigned)time(NULL)); // Seed randomizer
// If no arguments, this is the calling process
if (argc == 1)
{
// Spawn processes in numeric order
for (c = 0; c < 4; c++) {
_flushall();
process[c].hProcess = _spawnl(_P_NOWAIT, argv[0], argv[0],
process[c].name, NULL);
}
// Wait for randomly specified process, and respond when done
c = getrandom(0, 3);
printf("Come here, %s.\n", process[c].name);
_cwait(&termstat, process[c].hProcess, _WAIT_CHILD);
printf("Thank you, %s.\n", process[c].name);
}
// If there are arguments, this must be a spawned process
else
{
// Delay for a period that's determined by process number
Sleep((argv[1][0] - 'A' + 1) * 1000L);
printf("Hi, Dad. It's %s.\n", argv[1]);
}
}
El orden de la salida varía de una ejecución a otra.
Hi, Dad. It's Ann.
Come here, Ann.
Thank you, Ann.
Hi, Dad. It's Beth.
Hi, Dad. It's Carl.
Hi, Dad. It's Dave.