Starten ein Prozesses als ein anderer Benutzer von Visual Basic

Zusammenfassung

Dieser Artikel veranschaulicht das programmgesteuerte Starten eines Prozesses als ein anderer Benutzer von Microsoft Visual Basic. Dazu können LogonUser und CreateProcessAsUser Win32-APIs auf einem Computer mit Microsoft Windows NT 4.0 oder können die CreateProcessWithLogonW -Win32-API auf einem Computer mit Microsoft Windows 2000 oder höher. CreateProcessWithLogonW kann von einem Prozess unter dem Konto LocalSystem aufgerufen werden.

Weitere Informationen

Dieser Artikel enthält Visual Basic-Beispielcode, der die Version des Betriebssystems erkennt. Dann werden die entsprechenden APIs zum Starten eines Prozesses als ein anderer Benutzer verwendet.

Windows NT 4.0

Um LogonUser und CreateProcessAsUserverwenden, muss das aufrufende Benutzerkonto bestimmte Berechtigungen.


Um LogonUser()verwenden zu können, muss das aufrufende Benutzerkonto die folgende Berechtigungen:

   Permission                     Display Name
------------------------------------------------------------------
SE_TCB_NAME Act as part of the operating system


Um CreateProcessAsUser()verwenden zu können, muss das aufrufende Benutzerkonto beiden Berechtigungen:
   Permission                     Display Name
------------------------------------------------------------
SE_ASSIGNPRIMARYTOKEN_NAME Replace a process level token
SE_INCREASE_QUOTA_NAME Increase quotas


Wenn das aufrufende Benutzerkonto nicht über die Berechtigung "als Teil des Betriebssystems handeln" verfügt, LogonUser() API fehl und erzeugt den Rückgabewert NULL. Wenn Sie Err.LastDllErroraufrufen, wird Fehlermeldung 1314. Dies bedeutet, dass eine erforderliche Berechtigung vom Client nicht. Wenn das aufrufende Benutzerkonto nicht zwei Berechtigungen "ein Prozessebenentoken ersetzen" und "Kontingente erhöhen" verfügt, CreateProcessAsUser() API schlägt fehl und erzeugt die Fehlermeldung 1314.

Wenn Sie eine interaktive Anwendung als ein anderer Benutzer starten, benötigen Sie Zugriff auf die Arbeitsstation und Desktop mit dem Namen winsta0\default. Wenn die Anwendung interaktiv ist, muss der Aufrufer winsta0\default erforderliche Berechtigung programmgesteuert hinzugefügt. Danach kann der Aufrufer die Hilfsfunktion RunAsUser im Visual Basic-Beispielcode aufrufen.


Sie müssen ausreichende Berechtigungen für das Benutzerkonto, die LogonUser() entsprechen, damit die interaktive Anwendung erfolgreich gestartet werden kann. Der folgende Knowledge Base-Artikel ist Visual Basic-Beispielcode, mit dem Sie Berechtigungen auf einer Arbeitsstation und Desktop aktualisieren.

316440 Verwendung einfachen Zugriff Steuerelement APIs aus Visual Basic

Windows 2000 und höher

CreateProcessWithLogonW() API wurde in Windows 2000 eingeführt. Ein Aufruf von CreateProcessWithLogonW() erfordert keine Berechtigungen für das aufrufende Benutzerkonto mit LogonUser und CreateProcessAsUser APIs.


CreateProcessWithLogonW() API in Zukunft verwenden. Diese verarbeitet die Berechtigungen, die mit der übernommenen Arbeitsstation und Desktop. In diesem Szenario ruft die Anwendung einfach die Hilfsfunktion RunAsUser im folgenden Visual Basic-Code.

Option Explicit
Private Const CREATE_DEFAULT_ERROR_MODE = &H4000000

Private Const LOGON_WITH_PROFILE = &H1
Private Const LOGON_NETCREDENTIALS_ONLY = &H2

Private Const LOGON32_LOGON_INTERACTIVE = 2
Private Const LOGON32_PROVIDER_DEFAULT = 0

Private Type STARTUPINFO
cb As Long
lpReserved As Long ' !!! must be Long for Unicode string
lpDesktop As Long ' !!! must be Long for Unicode string
lpTitle As Long ' !!! must be Long for Unicode string
dwX As Long
dwY As Long
dwXSize As Long
dwYSize As Long
dwXCountChars As Long
dwYCountChars As Long
dwFillAttribute As Long
dwFlags As Long
wShowWindow As Integer
cbReserved2 As Integer
lpReserved2 As Long
hStdInput As Long
hStdOutput As Long
hStdError As Long
End Type

Private Type PROCESS_INFORMATION
hProcess As Long
hThread As Long
dwProcessId As Long
dwThreadId As Long
End Type

' LogonUser() requires that the caller has the following permission
' Permission Display Name
' --------------------------------------------------------------------
' SE_TCB_NAME Act as part of the operating system

' CreateProcessAsUser() requires that the caller has the following permissions
' Permission Display Name
' ---------------------------------------------------------------
' SE_ASSIGNPRIMARYTOKEN_NAME Replace a process level token
' SE_INCREASE_QUOTA_NAME Increase quotas

Private Declare Function LogonUser Lib "advapi32.dll" Alias _
"LogonUserA" _
(ByVal lpszUsername As String, _
ByVal lpszDomain As String, _
ByVal lpszPassword As String, _
ByVal dwLogonType As Long, _
ByVal dwLogonProvider As Long, _
phToken As Long) As Long

Private Declare Function CreateProcessAsUser Lib "advapi32.dll" _
Alias "CreateProcessAsUserA" _
(ByVal hToken As Long, _
ByVal lpApplicationName As Long, _
ByVal lpCommandLine As String, _
ByVal lpProcessAttributes As Long, _
ByVal lpThreadAttributes As Long, _
ByVal bInheritHandles As Long, _
ByVal dwCreationFlags As Long, _
ByVal lpEnvironment As Long, _
ByVal lpCurrentDirectory As String, _
lpStartupInfo As STARTUPINFO, _
lpProcessInformation As PROCESS_INFORMATION) As Long

' CreateProcessWithLogonW API is available only on Windows 2000 and later.
Private Declare Function CreateProcessWithLogonW Lib "advapi32.dll" _
(ByVal lpUsername As String, _
ByVal lpDomain As String, _
ByVal lpPassword As String, _
ByVal dwLogonFlags As Long, _
ByVal lpApplicationName As Long, _
ByVal lpCommandLine As String, _
ByVal dwCreationFlags As Long, _
ByVal lpEnvironment As Long, _
ByVal lpCurrentDirectory As String, _
ByRef lpStartupInfo As STARTUPINFO, _
ByRef lpProcessInformation As PROCESS_INFORMATION) As Long

Private Declare Function CloseHandle Lib "kernel32.dll" _
(ByVal hObject As Long) As Long

Private Declare Function SetErrorMode Lib "kernel32.dll" _
(ByVal uMode As Long) As Long

Private Type OSVERSIONINFO
dwOSVersionInfoSize As Long
dwMajorVersion As Long
dwMinorVersion As Long
dwBuildNumber As Long
dwPlatformId As Long
szCSDVersion As String * 128
End Type

' Version Checking APIs
Private Declare Function GetVersionExA Lib "kernel32.dll" _
(lpVersionInformation As OSVERSIONINFO) As Integer

Private Const VER_PLATFORM_WIN32_NT = &H2

'********************************************************************

' RunAsUser for Windows 2000 and Later
'********************************************************************
Public Function W2KRunAsUser(ByVal UserName As String, _
ByVal Password As String, _
ByVal DomainName As String, _
ByVal CommandLine As String, _
ByVal CurrentDirectory As String) As Long

Dim si As STARTUPINFO
Dim pi As PROCESS_INFORMATION

Dim wUser As String
Dim wDomain As String
Dim wPassword As String
Dim wCommandLine As String
Dim wCurrentDir As String

Dim Result As Long

si.cb = Len(si)

wUser = StrConv(UserName + Chr$(0), vbUnicode)
wDomain = StrConv(DomainName + Chr$(0), vbUnicode)
wPassword = StrConv(Password + Chr$(0), vbUnicode)
wCommandLine = StrConv(CommandLine + Chr$(0), vbUnicode)
wCurrentDir = StrConv(CurrentDirectory + Chr$(0), vbUnicode)

Result = CreateProcessWithLogonW(wUser, wDomain, wPassword, _
LOGON_WITH_PROFILE, 0&, wCommandLine, _
CREATE_DEFAULT_ERROR_MODE, 0&, wCurrentDir, si, pi)
' CreateProcessWithLogonW() does not
If Result <> 0 Then
CloseHandle pi.hThread
CloseHandle pi.hProcess
W2KRunAsUser = 0
Else
W2KRunAsUser = Err.LastDllError
MsgBox "CreateProcessWithLogonW() failed with error " & Err.LastDllError, vbExclamation
End If

End Function

'********************************************************************
' RunAsUser for Windows NT 4.0
'********************************************************************
Public Function NT4RunAsUser(ByVal UserName As String, _
ByVal Password As String, _
ByVal DomainName As String, _
ByVal CommandLine As String, _
ByVal CurrentDirectory As String) As Long
Dim Result As Long
Dim hToken As Long
Dim si As STARTUPINFO
Dim pi As PROCESS_INFORMATION

Result = LogonUser(UserName, DomainName, Password, LOGON32_LOGON_INTERACTIVE, _
LOGON32_PROVIDER_DEFAULT, hToken)
If Result = 0 Then
NT4RunAsUser = Err.LastDllError
' LogonUser will fail with 1314 error code, if the user account associated
' with the calling security context does not have
' "Act as part of the operating system" permission
MsgBox "LogonUser() failed with error " & Err.LastDllError, vbExclamation
Exit Function
End If

si.cb = Len(si)
Result = CreateProcessAsUser(hToken, 0&, CommandLine, 0&, 0&, False, _
CREATE_DEFAULT_ERROR_MODE, _
0&, CurrentDirectory, si, pi)
If Result = 0 Then
NT4RunAsUser = Err.LastDllError
' CreateProcessAsUser will fail with 1314 error code, if the user
' account associated with the calling security context does not have
' the following two permissions
' "Replace a process level token"
' "Increase Quotoas"
MsgBox "CreateProcessAsUser() failed with error " & Err.LastDllError, vbExclamation
CloseHandle hToken
Exit Function
End If

CloseHandle hToken
CloseHandle pi.hThread
CloseHandle pi.hProcess
NT4RunAsUser = 0

End Function

Public Function RunAsUser(ByVal UserName As String, _
ByVal Password As String, _
ByVal DomainName As String, _
ByVal CommandLine As String, _
ByVal CurrentDirectory As String) As Long

Dim w2kOrAbove As Boolean
Dim osinfo As OSVERSIONINFO
Dim Result As Long
Dim uErrorMode As Long

' Determine if system is Windows 2000 or later
osinfo.dwOSVersionInfoSize = Len(osinfo)
osinfo.szCSDVersion = Space$(128)
GetVersionExA osinfo
w2kOrAbove = _
(osinfo.dwPlatformId = VER_PLATFORM_WIN32_NT And _
osinfo.dwMajorVersion >= 5)
If (w2kOrAbove) Then
Result = W2KRunAsUser(UserName, Password, DomainName, _
CommandLine, CurrentDirectory)
Else
Result = NT4RunAsUser(UserName, Password, DomainName, _
CommandLine, CurrentDirectory)
End If
RunAsUser = Result
End Function

Eigenschaften

Artikelnummer: 285879 – Letzte Überarbeitung: 23.01.2017 – Revision: 2

Feedback