[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!

[GPRSNerd]

Hi,

Danke für das gute Tutorial und die hilfreichen Anmerkungen im Thread.

Ich starte jetzt zum Setzen von Kontextmenu-Einträgen im Explorer [liegen unter HKEY_CLASSES_ROOT] eine Helper-Applikation mit dem Manifest zur Anfrage von Admin-Rechten.
Funktioniert unter Windows 7 RC einwandfrei.

Danke,
Stefan

[Micha88]

ich habe alles genau so gemacht. Unter Windows 7 Home Premium funktioniertes nicht.

[soundmaun]

Haut hin! THX!

[Andreas Schilling]

Windows 7 Prof., Delphi 2007

Also bei mir will es einfach nicht funktionieren. Die erzeugte .res-Datei wird eingebunden (erkennt man daran, das das Programm-Icon weg ist).

Hier der Inhalt der res-datei

Delphi-Quellcode:

        ÿÿ  ÿÿ                  ]      ÿÿ ÿÿ     0         <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity
    type="win32"
    name="Update"
    version="1.0.0.2" 
    processorArchitecture="*"/>
  <dependency>
     <dependentAssembly>
        <assemblyIdentity
          type="win32"
          name="Microsoft.Windows.Common-Controls"
          version="6.0.0.0"
          publicKeyToken="6595b64144ccf1df"
          language="*"
          processorArchitecture="*"/>
      </dependentAssembly>
  </dependency>
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
    <security>
      <requestedPrivileges>
        <requestedExecutionLevel
          level="requireAdministrator"
          uiAccess="false"/>
        </requestedPrivileges>
      </security>
    </trustInfo>
  </assembly>

Wenn ich das Programm als User mit Adminrechten starte kann ich machen was ich will (in INI Schreiben usw.). Wenn ich als eingeschränkter User (nur Lokaler User) arbeite kommt beim Start keine Abfrage von der UAC (obwohl ich die höchste Stufe eingestellt habe) und das Programm macht dann nichts von dem was es machen soll (z.B. Speichern von Dateien im Ordner C:\progam files (x86)\...). Ist die res-datei noch nicht das was sie sein soll? Oben steht man soll die res-Datei hinter
{$R *.dfm} ins Projekt einbinden. Aber in der *.dpr gibt es den Eintrag nicht, nur auf dem Formular.

Gruß Andreas

[WM_CLOSE]

Es sieht so aus, als ob du das Dokument als ANSI gespeichert hast, aber im xml ist encoding=utf-8 angegeben.
Vielleicht mal einen anderen Editor benutzen? [GOOGLE]Notepad++[/GOOGLE].

[Andreas Schilling]

Nach dem Speichern mit Notepad sieht der Inhalt der res-datei zwar nicht anders aus, aber nach dem Compilieren hat die Exe dieses nette Sicherheitssymbol und es kommt jetzt die Anforderung der Adminrechte. Das Krönung des ganzen wäre jetzt noch wenn ich wieder mein Programmicon rein bekäme und die Versionsnummer ....

Gruß Andreas

[jaenicke]

Wenn dein Programmicon weg ist, sieht wahrscheinlich die .rc Datei zur Erzeugung der .res falsch aus. Hintergrund ist dann vermutlich, dass die Ressourcen-ID des Mainicons evtl. überschrieben wurde. Auch darf kein Ressourcenname (zumindest kein Icon) alphabetisch vor MAINICON kommen.

Oder du hast die .res Datei im gleichen Ordner liegen wie das Projekt, so dass Delphi die vor deinem Icon einbindet. (Die sollte immer in einem Unterordner liegen.)

Oder du hast die Einbindung der originalen .res aus Versehen entfernt.

[Andreas Schilling]

Die Einbindung der originalen res habe ich nicht ausversehen sondern mit Absicht entfernt. Da in keinem Beispiel das ich zu dem Thema gefunden hatte zwei Ressourcen standen, habe ich angenommen, das nur eine gehen kann und das Original auskommentiert. Nun habe ich beide drinnen und "fast" alles ist OK. Wenn ich jetzt aus der Entwicklungsumgebung heraus das Programm starten will kommt die Fehlermeldung "Vorgang kann nicht erzeugt werden". Kompilieren und dann im Explorer die EXE starten geht aber.

Gruß Andreas

Edit: Die Fehlermeldung hat aber wahrscheinlich nichts mit der Res-datei zu tun. Auch nach dem Auskommentieren der Zeile kommt die Fehlermeldung.

[jaenicke]

Die originale .res enthält das Icon und die Versionsinformationen, zudem noch diverse Standardicons für Buttons usw.

Zitat von Andreas Schilling:

Wenn ich jetzt aus der Entwicklungsumgebung heraus das Programm starten will kommt die Fehlermeldung "Vorgang kann nicht erzeugt werden".

Das liegt am Start als Admin. Einen Admin-Prozess kann man nur als Admin debuggen. Willst du also das Programm mit dem Debugger starten, musst du Delphi als Admin starten.

[Andreas Schilling]

Ja das habe ich mittlerweile auch heraus bekommen nachdem ich nach der Meldung gegoogelt hatte.

Gruß Andreas