Starts a process resource by specifying the name of an application, a set of command-line arguments, a user name, a password, and a domain and associates the resource with a new Process component.
(in System.dll)
Visual Basic (Declaration)
Public Shared Function Start ( _
fileName As String, _
arguments As String, _
userName As String, _
password As SecureString, _
domain As String _
) As Process
Dim fileName As String
Dim arguments As String
Dim userName As String
Dim password As SecureString
Dim domain As String
Dim returnValue As Process
returnValue = Process.Start(fileName, _
arguments, userName, password, domain)
public static Process Start(
string fileName,
string arguments,
string userName,
SecureString password,
string domain
)
public:
static Process^ Start(
String^ fileName,
String^ arguments,
String^ userName,
SecureString^ password,
String^ domain
)
public static function Start(
fileName : String,
arguments : String,
userName : String,
password : SecureString,
domain : String
) : Process
Return Value
Type:
System.Diagnostics..::.ProcessA new Process component that is associated with the process resource, or nullNothingnullptra null reference (Nothing in Visual Basic) if no process resource is started (for example, if an existing process is reused).
Use this overload to create a new process and its primary thread by specifying its file name, command-line arguments, user name, password, and domain. The new process then runs the specified executable file in the security context of the specified credentials (user, domain, and password).
.gif) Note: |
|---|
When the executable file is located on a remote drive, you must identify the network share by using a uniform resource identifier (URI), not a linked drive letter. |
The overload associates the resource with a new Process component. If the process is already running, no additional process resource is started. Instead, the existing process resource is reused and no new Process component is created. In such a case, instead of returning a new Process component, Start returns nullNothingnullptra null reference (Nothing in Visual Basic) to the calling procedure.
This overload lets you start a process without first creating a new Process instance. The overload is an alternative to the explicit steps of creating a new Process instance, setting the FileName, Arguments, UserName, Password, and Domain properties of the StartInfo property, and calling Start for the Process instance.
Similarly, in the same way that the Run dialog box can accept an executable file name with or without the .exe extension, the .exe extension is optional in the fileName parameter. For example, you can set the fileName parameter to either "Notepad.exe" or "Notepad". If the fileName parameter represents an executable file, the arguments parameter might represent a file to act upon, such as the text file in Notepad.exe myfile.txt.
| Note: |
|---|
The file name must represent an executable file in the Start overloads that have userName, password, and domain parameters. |
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0
Reference