createprocesswithlogonw (advapi32)
Last changed: -87.74.130.67

.
Summary
Starts a new process, opens an application in that proces, and uses a passed UserID and Password. The application opened is running under the credentials and authority of the UserID passed.

C# Signature:

[DllImport("advapi32.dll")]
static extern TODO CreateProcessWithLogonW(TODO);

VB .NET Signature:

<DllImport("advapi32.dll", EntryPoint:="CreateProcessWithLogonW", SetLastError:=True, CharSet:=CharSet.Unicode, CallingConvention:=CallingConvention.StdCall)>
Public Shared Function CreateProcessWithLogonW( _
  ByVal lpUsername As String, _
  ByVal lpDomain As String, _
  ByVal lpPassword As String, _
  ByVal dwLogonFlags As Integer, _
  ByVal lpApplicationName As String, _
  ByVal lpCommandLine As String, _
  ByVal dwCreationFlags As Integer, _
  ByVal lpEnvironment As IntPtr, _
  ByVal lpCurrentDirectory As String, _
  ByRef lpStartupInfo As STARTUPINFO, _
  ByRef lpProcessInformation As PROCESS_INFORMATION _
  ) As Integer
End Function

User-Defined Types:

Private Const LOGON_WITH_PROFILE = &H1

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>

Public Structure STARTUPINFO

Public cb As Integer
Public lpReserved As String
Public lpDesktop As String
Public lpTitle As String
Public dwX As Integer
Public dwY As Integer
Public dwXSize As Integer
Public dwYSize As Integer
Public dwXCountChars As Integer
Public dwYCountChars As Integer
Public dwFillAttribute As Integer
Public dwFlags As Integer
Public wShowWindow As Short
Public cbReserved2 As Short
Public lpReserved2 As Integer
Public hStdInput As Integer
Public hStdOutput As Integer
Public hStdError As Integer

End Structure

<StructLayout(LayoutKind.Sequential)>

Public Structure PROCESS_INFORMATION

Public hProcess As Integer
Public hThread As Integer
Public dwProcessId As Integer
Public dwThreadId As Integer

End Structure

Notes:

None.

Tips & Tricks:

Please add some!

Sample Code:

Public Shared Function OpenAppAsUser(ByVal username As String, ByVal domainname As String, ByVal password As String) As Boolean

'The Windows NT user token.
Dim lpAppName As String
Dim appExe As SR.[Assembly]
Dim pi As PROCESS_INFORMATION
Dim si As STARTUPINFO
Dim fResult As Boolean
Dim dwCreationFlags As Integer = Nothing
Dim lpCommandLine As String = Nothing
Dim lpEnvironment As IntPtr
Dim lpCurrentDirectory As String = Nothing
Dim ret As Integer

appExe = SR.Assembly.GetEntryAssembly()
lpAppName = appExe.Location
si.cb = Len(si)
si.lpTitle = appExe.GetName().Name

' call the Win32 API to open the application under the userID passed in
' Implicit Integer to Boolean conversion.  CreateProcessWithLogonW returns  0 (False) when it fails.
fResult = CreateProcessWithLogonW(username, domainname, password,    LOGON_WITH_PROFILE, lpAppName, lpCommandLine, dwCreationFlags,   lpEnvironment, lpCurrentDirectory, si, pi)

' if the logon fails then we need to generate an error
If Not fResult Then
   ' get the last error from Windows
   ret = Marshal.GetLastWin32Error

   ' if the userid, password, or domain is bad we can display a friendly message
   If ret = 1326 Then
     MessageBox.Show("Invalid UserID or Password entered.  Please try again.", "Logon Error")
     Return False
   Else
     ' the error code is unexpected so throw an exception to be logged.
     Dim retMsg = GetErrorMessage(ret)
     Throw New MAE.BaseApplicationException("Error occurred: " + ret.ToString() + " - " + retMsg)
     Return False
   End If
End If

Return True

End Function

Alternative Managed API:

TODO

Documentation