_cwait

更新 : 2007 年 11 月

ほかのプロセスが終了するまで待機します。

intptr_t _cwait( 
   int *termstat,
   intptr_t procHandle,
   int action 
);

パラメータ

• termstat
  指定されたプロセスの結果コードを格納するバッファへのポインタまたは NULL。

• procHandle
  待機するプロセスへのハンドル (_cwait が処理を戻す前に終了する必要のあるプロセス)。

• action
  Windows オペレーティング システムのアプリケーションでは無視されて、NULL を返します。それ以外のアプリケーションでは、procHandle に対して実行するアクション コードを返します。

戻り値

指定されたプロセスが正常に完了すると、プロセスのハンドルを返し、termstat にプロセスの結果コードを設定します。正常に完了しなかった場合は、–1 を返し、errno に次の値を設定します。

リターン コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

_cwait 関数は、procHandle で指定されたプロセスのプロセス ID が終了するまで待機します。_cwait に渡された procHandle の値には、指定されたプロセスを作成する _spawn 関数の呼び出しによって返される値を指定します。プロセス ID が _cwait の呼び出し前に終了した場合、_cwait はすぐに処理を戻します。プロセスで _cwait を使用すると、有効なハンドル (procHandle) を持つ別のプロセスを待機できます。

termstat は、指定されたプロセスのリターン コードを格納するバッファへのポインタです。termstat の値は、Windows NT ExitProcess API を呼び出して指定されたプロセスが正常に終了したかどうかを示します。指定されたプロセスが exit または _exit を呼び出した場合、main から戻った場合、main の終端に達した場合のいずれかで、ExitProcess が内部的に呼び出されます。termstat 経由で返される値の詳細については、「GetExitCodeProcess」を参照してください。termstat に NULL 値を指定して _cwait を呼び出すと、指定したプロセスのリターン コードは格納されません。

Windows オペレーティング システムの環境では、プロセスの親子関係が実装されていないため、action パラメータは無視されます。

procHandle が -1 または -2 (現在のプロセスまたはスレッドへのハンドル) でない限り、ハンドルは閉じられます。したがって、この状況では、返されたハンドルは使用しないでください。

必要条件

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

// crt_cwait.c
// compile with: /c
// This program launches several processes and waits
// for a specified process to finish.
//

#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() % (int)((( max ) + 1 ) - ( min ))) + ( min ))

struct PROCESS
{
   int     nPid;
   char    name[40];
} process[4] = { { 0, "Ann" }, { 0, "Beth" }, { 0, "Carl" }, { 0, "Dave" } };

int main( int argc, char *argv[] )
{
   int termstat, c;

   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].nPid = _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].nPid, _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 determined by process number
      Sleep( (argv[1][0] - 'A' + 1) * 1000L );
      printf( "Hi, Dad. It's %s.\n", argv[1] );
   }
}

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.

.NET Framework の相当するアイテム

System::Diagnostics::Process::WaitForExit

参照

参照

プロセス制御と環境制御

_spawn 系関数と _wspawn 系関数