[Vista / UAC] Programm mit Adminrechten starten

[TheMiller]

Hallo,

in letzter Zeit musste ich oft in Programme das Vista-Manifest einbinden, welches dem Endbenutzer erlaubt, das Programm mit Adminrechten zu starten (evtl. Update-Programm o.ä).

Nun gibt es hier in der DP einige Einträge zu diesem Thema, aber immernoch manchmal Probleme. Nun versuche ich euch eine Lösung näher zu bringen und auf einen oft gemachten Fehler einzugehen, der wohl bei dem Einen oder Anderen, aus Flüchtigkeit passiert (siehe Punkt 4).


Übersicht
====================

1. Manifest erstellen
2. Manifest als Resource erstellen
3. Projekt mit Manifest compilieren
4. Wenn das Manifest "nicht funktioniert"
5. Schlusswort



1. Manifest erstellen

Eine Manifest-Datei besteht aus einer XML-Struktur, die unter dem Namen <Programmname>.exe.manifest gespeichert wird. Der Inhalt der Manifest-Datei ist - je nach Bedarf - verschieden. Hier verwende ich ein Standard-Manifest, welches Vista sagt, dass das Programm nur mit Administrationsrechten gestartet werden darf. Dies ist beispielsweise bei Update-Programmen notwendig.

Code:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0"> 
  <assemblyIdentity version="1.0.0.0" processorArchitecture="X86" name="VistaLogonCustomizer.exe" type="*"/> 
  <description>elevate execution level</description> 
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2"> 
   <security> 
     <requestedPrivileges> 
      <requestedExecutionLevel level="requireAdministrator"/> 
     </requestedPrivileges> 
   </security> 
  </trustInfo> 
  <dependency> 
   <dependentAssembly> 
     <assemblyIdentity type="win32" name="Microsoft.Windows.Common-Controls" version="6.0.0.0" publicKeyToken="6595b64144ccf1df" language="*" processorArchitecture="*"/> 
   </dependentAssembly> 
  </dependency> 
</assembly>

Die Schlüsselstelle (für unsere Zwecke) stellt folgender Knoten aus dem Manifest dar:

Code:

<requestedPrivileges> 
 <requestedExecutionLevel level="requireAdministrator"/> 
</requestedPrivileges>

Mit RequestedExecutionLevel können wir der UAC sagen, welche Rechte wir brauchen. Hier steht als Level "requireAdministrator". Neben diesem gibt es noch zwei andere Level - und zwar "asInvoker" sowie "highestAvailable".

requireAdministrator ist das höchste Level, welches man anfordern kann. Es sagt, dass das Programm nur mit Admin-Rechten ausgeführt werden darf. Bekommt es diese nicht, wird das Programm nicht gestartet.

highestAvailable ist das nächst kleinere Level. Es fragt nach Adminrechten, bekommt es diese nicht, wird das Programm mit den Standard-Userrechten ausgeführt.

asInvoker bezeichnet das kleinste Level. Das Programm wird mit den Rechten gestartet, die der Prozess der das Programm starten will, hat. Also wenn ein Programm, welches Admin-Rechte hat, ein neues Programm mit dem Level (asInvoker) startet, bekommt es auch Admin-Rechte.

Hinweis: CodeGear weist darauf hin, dass ein fehlerhaft formatiertes Manifest bei Windows XP einen BlueScreen erzeugen kann.

Ich kenne jetzt auch nicht alle Manifeste (?), aber ich habe bisher bei dem oben abgedruckten noch keine Probleme feststellen können.

Nun erstellt im Quellcodeverzeichnis des Projekts eine neue Textdatei, in die ihr das Manifest einfügt und speichert die Datei unter dem Namen <Programmname>.exe.manifest.


2. Manifest in die Exe einbinden

Als nächstes werden wir aus dem erstellten Manifest eine Resource erstellen, damit es direkt in das Programm einkompiliert werden kann. Man könnte das Manifest auch als externe Datei mitliefern, aber diese Variante ist eher unschön.

Also erstellen wir eine weitere Datei im gleichen Verzeichnis mit dem Namen <Programmname>.rc. Diese Datei sollte folgenden Inhalt haben:

Zitat:

1 24 "<programmname>.exe.manifest"

Die "1" bezeichnet den Index der Resource, die "24" den Type der Resource. Die RC-Datei stellt für den Resource-Builder von Delphi sozusagen die "Compileranweisung" für die Erstellung der Resource dar. Da wir die RC-Datei erstellt und gespeichert haben, werden wir jetzt die Resource auch erstellen.

Also, ab in die Kommandozeile (Start -> Ausführen -> cmd)

Zitat:

brcc32 -v <programmname>.rc -fo<programmname>.res

-v bedeutet, dass alle Ausgaben, die der Compiler erstellt, nicht unterdrückt, sondern dem Benutzer ausgegeben werden.
-fo<programmname> gibt den Dateinamen an, unter dem die Resource erstellt wird.

Nach der Ausführung sollte eine solche Ausgabe auf der Konsole erscheinen:

Zitat von cmd:

Borland Resource Compiler Version 5.40
Copyright (c) 1990, 1999 Inprise Corporation. All rights reserved.

Lines: Current 0, Total 0
New File: Project1.rc
Lines: Current 1, Total 0
New File: C:\Users\<benutzer>\Desktop\manifest\Project1.exe
Lines: Current 0, Total 0
New File: C:\Users\<benutzer>\Desktop\manifest\Project1.res
Lines: Current 1, Total 1
Compiling 24:1

C:\Users\<benutzer>\Desktop\manifest>

3. Projekt mit Manifest compilieren

Nun haben wir eine schöne Resource, die wir in das Projekt einbinden können. Unter der bestehenden Einbindung der DFM-Datei, schreiben wir unsere Manifest-Resource hin:

Delphi-Quellcode:

{$R *.dfm}
{$R manifest.res}

Wenn das Programm jetzt erstellt wird, wird das Manifest mit eingebunden. Beim nächsten Start des Programms sollte die UAC aufgerufen werden, falls nicht, lest den folgenden Punkt!


4. Wenn das Manifest "nicht funktioniert"

Ist das Manifest nach den oberen Schritten eingebunden worden und die UAC wird NICHT geladen, ist die Hauptursache das Vorhandensein des Windows-XP-Manifests - WindowsXP und WindowsVista Manifests dürfen nicht kombiniert werden! Es ist vielmehr so, dass das Vista-Manifest alles Erforderliche des WindowsXP-Manifests enthält und die Vista-spezifischen Anweisungen von Windows XP ignoriert werden.

Also auf allen Formularen die XP-Man Komponente entfernen UND aus allen Units des Projekts die dazugehörige Unit XPMan entfernen. Danach das Projekt neu kompilieren und dann sollte es funktionieren!


5. Schlusswort

Ich hoffe, ich konnte euch bei der Anforderung von Adminrechten unter Windows Vista helfen. Es gibt zwar noch andere Methoden innerhalb der Manifest-Datei um Adminrechte anzufordern, aber das sollte erstmal genügen. Allerdings sollte nicht jedes Projekt, was ihr in Zukunft erstellt, dieses Manifest benutzen, dess es fordert immer Admin-Rechte an und kann nicht ohne Admin-Rechte starten!

Feedback ist natürlich gerne erwünscht, sowohl positives als auch negatives. Doch bedenkt - es war mein erstes Mal

Grüße!

[haentschman]

ist dann doch noch nicht vorbei...

in meinem Projekt habe ich 2 EXE, welche das Vista Manifest bekommen sollen.

1. EXE eAV wie oben beschrieben funktioniert.
2. EXE Update Fehler

Zitat:

[DCC Fehler] E2161 Warning: Duplicate resource: Type 24 (user-defined), ID 1; File eAVVista.res resource kept; file eAVVista.res resource discarded.

- Themes zur Laufzeit deaktiviert
- XPMan nicht vorhanden
- Update.res gelöscht und neu erstellen lassen
- seperate res für Update gemacht eAVVistaU.res Fehler der gleiche mit eAVVistaU.res im Text.



bitte helft mir auf die Sprünge... Danke

PS: google liefert zu "E2161 type 24" nicht besonders viel

[Luckie]

Du hast zweimal die Ressource mit der ID oder dem Typ 24 deklariert. Ob Typ oder ID, da bin ich mir nicht so ganz sicher.

[haentschman]

nun ja... soweit kann ich folgen. Ich wüßte nur gern wo ?

- im Programm Update steht nur Standard {$R *.DFM}
- im Programm eAV steht {$R *.DFM} und {$R eAVVista.res}
da die Quelltexte beider EXE und die Resourcedatei in einem Projektverzeichnis stehen könnte es möglich sein, daß die Recorcedatei automatisch mitcompiliert wird durch {$R *.RES} im Quelltext der Projektdatei und ich das dadurch doppelt habe ?

[MCXSC]

Wenn ich die RES einbinde, und dann das Programm compiliere/starte (also über F9), hängt sich Delphi bei dem eigentlichen Programmstart auf ("Keine Rückmeldung") - wenn ich nur compiliere (über STRG+F9) funktioniert alles wie es soll und nichts hängt sich auf. Jemand eine Idee?

[ak-ac]

Habt ihr mal versucht das Laufzeit-Thema des Projektes zu deaktivieren? Ich glaube D2009 erstellt darüber auch ein eigenes Manifest und bindet das automatisch ein.

[himitsu]

Zitat von ak-ac:

Ich glaube D2009 erstellt darüber auch ein eigenes Manifest und bindet das automatisch ein.

jupp, es bindet standardmäßig ein eigenes XP-Manifest ein.

[mkinzler]

Welches man über die Projekteinstellungen konfigurieren kann

[ak-ac]

Zitat von mkinzler:

Welches man über die Projekteinstellungen konfigurieren kann

eheisst das, ich kann mir die vista-manifeste sparen und dort den UAV-Level direkt auswählen?

[mkinzler]

Bisher leider nicht. Man kann aber die Verwendung der Themes an und abschalten
Eigene Ressourcen kann man auch direkt einbinden

[ak-ac]

Zitat von mkinzler:

Bisher leider nicht. Man kann aber die Verwendung der Themes an und abschalten
Eigene Ressourcen kann man auch direkt einbinden

ah danke! dann habe ich's ja richtig gemacht, und dass dann über entsprechende manifest dateien eingebudnen. die sind schwerer zu finden als man denk ;o) - aber der beitrag hat mir sehr weitergeholfen! werde jetzt noch die elevationroutine einbinden und dann läuft es bei mir endlich...