文書番号: 194948 - 最終更新日: 2004年2月4日 - リビジョン: 1.0

[IIS]HOWTO: CGI プロセスから子コンソールを作成する方法

お知らせお使いのオペレーティング システムには適用しない情報が含まれている場合があります。
この記事は、以前は次の ID で公開されていました: JP194948
すべて展開する | すべて折りたたむ

概要

C ランタイム ルーチン _popen() を使用して CGI プロセス内部から子プロセスを作成するとき、STDIN ハンドルと STDOUT (または STDERR) ハンドルのマッピングに関して、いくつかの問題が発生します。IIS (Internet Information Server) 3.0 および 4.0 ではデフォルトで CGI プロセス作成時にコンソールが作成されません。CGI プロセスおよび CGI プロセスから派生する子プロセスの STDIN ハンドルと STDOUT ハンドルが正しくマップされません。

詳細

たとえば次のようなコードがあっても、ブラウザに子プロセスからのメッセージが表示されません。
   /* Parent.c -- This is the CGI process created by IIS */ 

   int main(int argc, char *argv[])
   {
      FILE  *pFile = _popen("c:\\inetput\\scripts\\child.exe", "rt");
      char  cBuf[256];

      printf("HTTP/1.0 200 Ok\r\nContent-Type: test/html\r\n\r\n");
      printf("<H1>I'm the Parent...</H1>");

      while(!feof(pFile))
      {
         fgets(cBuf, 256, pFile);
         printf("%s", cBuf);
      }
      _pclose (pFile);
      return 0;
   }

   /* Child.c -- This is the child process created by Parent */ 

   int main(int argc, char *argv[])
   {
      printf("<H1>Hello, I'm the child.</H1>");
      return 0;
   }

これは、_popen() が呼び出された時点で親プロセスにコンソールが存在しないためです。これが原因で STDIN、STDOUT、および STDERR ハンドルは無効になります。厳密に言えば、IIS によって親プロセスに疑似標準ハンドルが提供されます。その結果、子プロセスをマップしていない STDIN や STDOUT を使って FILE ポインタが作成されます。

このデフォルトの現象には、以下の 2 つの回避策があります。
  • IIS に、コンソールを含むすべての CGI アプリケーションを強制的に起動させます。そのためには、IIS 3.0 の場合、HKLM\CurrentControlSet\Services\W3SVC\Parameters の CreateProcessWithNewConsole DWORD レジストリ エントリを 1 に設定します。IIS 4.0 の場合、IIS Admin Base オブジェクトを使用してメタベースの MD_CREATE_PROC_NEW_CONSOLE エントリを TRUE に設定するか、または IIS Admin オブジェクトを使用して対応する CreateCGIWithNewConsole プロパティを TRUE に設定します (詳細については IIS 4.0 オンライン ドキュメントを参照してください)。
  • IIS の構成を変更できない場合は、プログラムを修正して、親プロセスが AllocConsole() を呼び出して確実にコンソールを作成するように設定します。この呼び出しは、親プロセスに既にコンソールが存在する場合は実行されませんが、コンソールが存在しなければ、この呼び出しによってコンソールが割り当てられ、親プロセスに関連付けられます。注 : 必ず _popen() よりも先に AllocConsole() を呼び出します。そうしないと、_popen() ルーチンは、割り当てられたコンソールの標準 I/O ハンドルを検出できません。

関連情報

IIS 3.0 製品マニュアル

IIS 4.0 オンライン マニュアル

関連情報

この資料は米国 Microsoft Corporation から提供されている Knowledge Base の Article ID 194948? (http://support.microsoft.com/kb/194948/EN-US/ ) (最終更新日 1999-05-06) をもとに作成したものです。

この資料に含まれているサンプル コード/プログラムは英語版を前提に書かれたものをありのままに記述しており、日本語環境での動作は確認されておりません。


この資料は以下の製品について記述したものです。
  • Microsoft Internet Information Server 3.0
  • Microsoft Internet Information Server 4.0
キーワード:?
kbhowto kbwebserver kbinternet kbcgi KB194948
"Microsoft Knowledge Baseに含まれている情報は、いかなる保証もない現状ベースで提供されるものです。Microsoft Corporation及びその関連会社は、市場性および特定の目的への適合性を含めて、明示的にも黙示的にも、一切の保証をいたしません。さらに、Microsoft Corporation及びその関連会社は、本文書に含まれている情報の使用及び使用結果につき、正確性、真実性等、いかなる表明・保証も行ないません。Microsoft Corporation、その関連会社及びこれらの権限ある代理人による口頭または書面による一切の情報提供またはアドバイスは、保証を意味するものではなく、かつ上記免責条項の範囲を狭めるものではありません。Microsoft Corporation、その関連会社 及びこれらの者の供給者は、直接的、間接的、偶発的、結果的損害、逸失利益、懲罰的損害、または特別損害を含む全ての損害に対して、状況のいかんを問わず一切責任を負いません。(Microsoft Corporation、その関連会社 またはこれらの者の供給者がかかる損害の発生可能性を了知している場合を含みます。) 結果的損害または偶発的損害に対する責任の免除または制限を認めていない地域においては、上記制限が適用されない場合があります。なお、本文書においては、文書の体裁上の都合により製品名の表記において商標登録表示、その他の商標表示を省略している場合がありますので、予めご了解ください。"