Search
Module:
Directory

   Desktop Functions:

   Smart Device Functions:


Show Recent Changes
Subscribe (RSS)
Misc. Pages
Comments
FAQ
Helpful Tools
Playground
Suggested Reading
Website TODO List
Download Visual Studio Add-In

CreateProcess (kernel32)
 
.
Summary
Creates a new process and its primary thread.

C# Signature:

[DllImport("kernel32.dll", SetLastError=true, CharSet=CharSet.Auto)]
static extern bool CreateProcess(
   string lpApplicationName,
   string lpCommandLine,
   ref SECURITY_ATTRIBUTES lpProcessAttributes,
   ref SECURITY_ATTRIBUTES lpThreadAttributes,
   bool bInheritHandles,
   uint dwCreationFlags,
   IntPtr lpEnvironment,
   string lpCurrentDirectory,
   [In] ref STARTUPINFO lpStartupInfo,
   out PROCESS_INFORMATION lpProcessInformation);

VB Signature:

<DllImport("kernel32.dll")> _
Shared Function CreateProcess( _
    lpApplicationName As String, _
    lpCommandLine As String, _
    ByRef lpProcessAttributes As SECURITY_ATTRIBUTES, _
    ByRef lpThreadAttributes As SECURITY_ATTRIBUTES, _
    bInheritHandles As Boolean, _
    dwCreationFlags As UInt32, _
    lpEnvironment As IntPtr, _
    lpCurrentDirectory As String, _
    <[In]> ByRef lpStartupInfo As STARTUPINFO, _
    <[Out]> ByRef lpProcessInformation As PROCESS_INFORMATION) As Boolean
End Function

Boo Signature:

[DllImport("kernel32.dll", SetLastError : true)]
def CreateProcess(
    lpApplicationName as string,
    lpCommandLine as string,
    ref lpProcessAttributes as SECURITY_ATTRIBUTES,
    ref lpThreadAttributes as SECURITY_ATTRIBUTES,
    bInheritHandles as bool,
    dwCreationFlags as CreationFlags,
    lpEnvironment as IntPtr,
    lpCurrentDirectory as string,
    ref lpStartupInfo as STARTUPINFOEX,
    ref lpProcessInformation as PROCESS_INFORMATION) as bool:
     pass

User-Defined Types:

[StructLayout(LayoutKind.Sequential)]
struct SECURITY_ATTRIBUTES:
     nLength as int
     lpSecurityDescriptor as IntPtr
     lpSecurityDescriptor as

[Flags]
enum CreationFlags:
     CreateSuspended = 0x00000004
     DetachedProcess = 0x00000008
     DetachedProcesds = 0x00000008
     CreateNoWindow = 0x08000000
     ExtendedStartupInfoPresent = 0x00080000

[StructLayout(LayoutKind.Sequential)]
struct STARTUPINFO:
     cb as uint
     lpReserved as IntPtr
     lpDesktop as IntPtr
     lpTitle as IntPtr
     dwX as uint
     dwY as uint
     dwXSize as uint
     dwYSize as uint
     dwXCountChars as uint
     dwYCountChars as uint
     dwFillAttributes as uint
     dwFlags as uint
     wShowWindow as ushort
     cbReserved as ushort
     lpReserved2 as IntPtr
     hStdInput as IntPtr
     hStdOutput as IntPtr
     hStdErr as IntPtr

[StructLayout(LayoutKind.Sequential)]
struct STARTUPINFOEX:
     StartupInfo as STARTUPINFO
     lpAttributeList as IntPtr

[StructLayout(LayoutKind.Sequential)]
struct PROCESS_INFORMATION:
     hProcess as IntPtr
     hThread as IntPtr
     dwProcessId as int
     dwThreadId as int

Notes:

This is great for starting an external app and then using the PID and handle for calls to functions such as WaitForSingleObject and all window message functions.

Replace STARTUPINFO with STARTUPINFOEX to use UpdateProcThreadAttribute and extend CreateProcess. Make sure you include the flag EXTENDED_STARTUPINFO_PRESENT (0x00080000)

Tips & Tricks:

Add this in constructor of a class to logically treat the app as an object.

Sample Code C#:

public static void StartupNotepad()
{
     const uint NORMAL_PRIORITY_CLASS = 0x0020;

     bool retValue;
     string Application = Environment.GetEnvironmentVariable("windir") + @"\Notepad.exe";
     string CommandLine = @" c:\boot.ini";
     PROCESS_INFORMATION pInfo = new PROCESS_INFORMATION();
     STARTUPINFO sInfo = new STARTUPINFO();
     SECURITY_ATTRIBUTES pSec = new SECURITY_ATTRIBUTES();
     SECURITY_ATTRIBUTES tSec = new SECURITY_ATTRIBUTES();
     pSec.nLength = Marshal.SizeOf(pSec);
     tSec.nLength = Marshal.SizeOf(tSec);

     //Open Notepad
     retValue = CreateProcess(Application,CommandLine,
     ref pSec,ref tSec,false,NORMAL_PRIORITY_CLASS,
     IntPtr.Zero,null,ref sInfo,out pInfo);

     Console.WriteLine("Process ID (PID): " + pInfo.dwProcessId);
     Console.WriteLine("Process Handle : " + pInfo.hProcess);
}

Sample Code VB:

Public Shared Sub StartupNotepad()
      Const NORMAL_PRIORITY_CLASS AS UInt32 = &h2

     Dim retValue As Boolean
     Dim Application As String = Environment.GetEnvironmentVariable("windir") & "\Notepad.exe"
     Dim CommandLine As String = " c:\boot.ini"
     Dim pInfo As PROCESS_INFORMATION = New PROCESS_INFORMATION()
     Dim sInfo As STARTUPINFO = New STARTUPINFO()
     Dim pSec As SECURITY_ATTRIBUTES  = New SECURITY_ATTRIBUTES()
     Dim tSec As SECURITY_ATTRIBUTES = New SECURITY_ATTRIBUTES()
     pSec.nLength = Marshal.SizeOf(pSec)
     tSec.nLength = Marshal.SizeOf(tSec)

     retValue = CreateProcess(Application, CommandLine, pSec, tSec, False, NORMAL_PRIORITY_CLASS, IntPtr.Zero, vbNull, sInfo, pInfo)

     Console.WriteLine("Process ID (PID): " + pInfo.dwProcessId)
     Console.WriteLine("Process Handle : " + pInfo.hProcess)
End Sub

Alternative Managed API:

System.Diagnostics.Process.Start

Further Reading

If the approach outlined above does not work verbatim, try the variation by Thottam R. Sriram: http://blogs.msdn.com/thottams/archive/2006/08/11/696013.aspx

Documentation

Please edit this page!

Do you have...

  • helpful tips or sample code to share for using this API in managed code?
  • corrections to the existing content?
  • variations of the signature you want to share?
  • additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).

 
Access PInvoke.net directly from VS:
Terms of Use
Edit This Page
Find References
Show Printable Version
Revisions