home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _b0cae9e5e451383f3c062ae6ae1f915e < prev    next >
Text File  |  2000-03-23  |  5KB  |  135 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Win32::Process - Create and manipulate processes.</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Win32::Process - Create and manipulate processes.</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#methods">METHODS</A></LI>
  26. </UL>
  27. <!-- INDEX END -->
  28.  
  29. <HR>
  30. <P>
  31. <H1><A NAME="name">NAME</A></H1>
  32. <P>Win32::Process - Create and manipulate processes.</P>
  33. <P>
  34. <HR>
  35. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  36. <UL>
  37. <LI>Windows</LI>
  38. </UL>
  39. <HR>
  40. <H1><A NAME="synopsis use win32::process; use win32;">SYNOPSIS
  41.     use Win32::Process;
  42.     use Win32;</A></H1>
  43. <PRE>
  44.         sub ErrorReport{
  45.                 print Win32::FormatMessage( Win32::GetLastError() );
  46.         }</PRE>
  47. <PRE>
  48.         Win32::Process::Create($ProcessObj,
  49.                                 "D:\\winnt35\\system32\\notepad.exe",
  50.                                 "notepad temp.txt",
  51.                                 0,
  52.                                 NORMAL_PRIORITY_CLASS,
  53.                                 ".")|| die ErrorReport();</PRE>
  54. <PRE>
  55.         $ProcessObj->Suspend();
  56.         $ProcessObj->Resume();
  57.         $ProcessObj->Wait(INFINITE);</PRE>
  58. <P>
  59. <HR>
  60. <H1><A NAME="description">DESCRIPTION</A></H1>
  61. <P>This module allows for control of processes in Perl.</P>
  62. <P>
  63. <HR>
  64. <H1><A NAME="methods">METHODS</A></H1>
  65. <DL>
  66. <DT><STRONG><A NAME="item_Create">Win32::Process::Create($obj,$appname,$cmdline,$iflags,$cflags,$curdir)</A></STRONG><BR>
  67. <DD>
  68. Creates a new process.
  69. <PRE>
  70.     Args:</PRE>
  71. <PRE>
  72.         $obj            container for process object
  73.         $appname        full path name of executable module
  74.         $cmdline        command line args
  75.         $iflags         flag: inherit calling processes handles or not
  76.         $cflags         flags for creation (see exported vars below)
  77.         $curdir         working dir of new process</PRE>
  78. <P></P>
  79. <DT><STRONG><A NAME="item_KillProcess">Win32::Process::KillProcess($pid, $exitcode)</A></STRONG><BR>
  80. <DD>
  81. Terminates any process identified by $pid.  The process will exit
  82. with $exitcode.
  83. <P></P>
  84. <DT><STRONG><A NAME="item_Suspend">$ProcessObj-><CODE>Suspend()</CODE></A></STRONG><BR>
  85. <DD>
  86. Suspend the process associated with the $ProcessObj.
  87. <P></P>
  88. <DT><STRONG><A NAME="item_Resume">$ProcessObj-><CODE>Resume()</CODE></A></STRONG><BR>
  89. <DD>
  90. Resume a suspended process.
  91. <P></P>
  92. <DT><STRONG><A NAME="item_Kill">$ProcessObj->Kill( $ExitCode )</A></STRONG><BR>
  93. <DD>
  94. Kill the associated process, have it die with exit code $ExitCode.
  95. <P></P>
  96. <DT><STRONG><A NAME="item_GetPriorityClass">$ProcessObj-><CODE>GetPriorityClass($class)</CODE></A></STRONG><BR>
  97. <DD>
  98. Get the priority class of the process.
  99. <P></P>
  100. <DT><STRONG><A NAME="item_SetPriorityClass">$ProcessObj->SetPriorityClass( $class )</A></STRONG><BR>
  101. <DD>
  102. Set the priority class of the process (see exported values below for
  103. options).
  104. <P></P>
  105. <DT><STRONG><A NAME="item_GetProcessAffinitymask">$ProcessObj->GetProcessAffinitymask( $processAffinityMask, $systemAffinitymask)</A></STRONG><BR>
  106. <DD>
  107. Get the process affinity mask.  This is a bitvector in which each bit
  108. represents the processors that a process is allowed to run on.
  109. <P></P>
  110. <DT><STRONG><A NAME="item_SetProcessAffinitymask">$ProcessObj->SetProcessAffinitymask( $processAffinityMask )</A></STRONG><BR>
  111. <DD>
  112. Set the process affinity mask.  Only available on Windows NT.
  113. <P></P>
  114. <DT><STRONG><A NAME="item_GetExitCode">$ProcessObj->GetExitCode( $ExitCode )</A></STRONG><BR>
  115. <DD>
  116. Retrieve the exitcode of the process.
  117. <P></P>
  118. <DT><STRONG><A NAME="item_Wait">$ProcessObj-><CODE>Wait($Timeout)</CODE></A></STRONG><BR>
  119. <DD>
  120. Wait for the process to die. forever = INFINITE
  121. <P></P>
  122. <DT><STRONG><A NAME="item_GetProcessID">$ProcessObj-><CODE>GetProcessID()</CODE></A></STRONG><BR>
  123. <DD>
  124. Returns the Process ID.
  125. <P></P></DL>
  126. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  127. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  128. <STRONG><P CLASS=block> Win32::Process - Create and manipulate processes.</P></STRONG>
  129. </TD></TR>
  130. </TABLE>
  131.  
  132. </BODY>
  133.  
  134. </HTML>
  135.