SHCreateProcessAsUserW-Funktion (shellapi.h)
[SHCreateProcessAsUserW ist unter Windows XP oder höher nicht implementiert.]
Erstellt einen neuen Benutzermodusprozess und seinen primären Thread, um eine angegebene ausführbare Datei auszuführen.
Syntax
BOOL SHCreateProcessAsUserW(
[in, out] PSHCREATEPROCESSINFOW pscpi
);
Parameter
[in, out] pscpi
Typ: PSHCREATEPROCESSINFOW
Ein Zeiger auf eine SHCREATEPROCESSINFOW-Struktur mit Informationen zum Erstellen des Prozesses.
Rückgabewert
Typ: BOOL
Gibt TRUE zurück, wenn erfolgreich, oder FALSE , wenn nicht. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Diese Funktion ähnelt ShellExecuteEx mit runas als Verb. SHCreateProcessAsUserW erstellt jedoch einen Prozess, der im Sicherheitskontext des Benutzers ausgeführt wird, der durch den hUserToken-Member der Struktur dargestellt wird, auf die von pscpi verwiesen wird. Das lpProcessInformation-Element kann verwendet werden, um eine PROCESS_INFORMATION-Struktur mit Informationen zum neuen Prozess zurückzugeben.
Das Runas-Verb muss vom Dateityp der ausführbaren Datei unterstützt werden. Der Dateityp .exe unterstützt runas. Verwenden Sie die AssocQueryString-Funktion , um zu überprüfen, ob runas von anderen Dateitypen unterstützt wird. Das folgende Codefragment veranschaulicht die Syntax.
AssocQueryString(0, ASSOCSTR_COMMAND, pszFile, TEXT("runas"), NULL, &cchVerb)
Eine Erläuterung der Verwendung der Shell zum Starten von Anwendungen finden Sie unter Starten von Anwendungen.
SHCreateProcessAsUserW wird unter Windows XP nicht unterstützt. Benutzer, die ähnliche Funktionen benötigen, sollten CreateProcess,CreateProcessAsUser, CreateProcessWithLogonW und ShellExecuteEx untersuchen und diese basierend auf der erforderlichen Funktionalität und Sicherheit sorgfältig bewerten. IQueryAssociations kann verwendet werden, um informationen zu extrahieren, die mit CreateProcess verwendet werden, falls erforderlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shellapi.h |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 5.0 oder höher) |