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!

The GetErrorMessage method called below uses the FormatMessage API from the kernel32 DLL.

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