Teilen über

-win32manifest (Visual Basic)

  • Artikel

Identifiziert eine benutzerdefinierte Win32-Anwendungsmanifestdatei, die in die übertragbare ausführbare Datei (PE) eines Projekts eingebettet werden soll.

Syntax

-win32manifest: fileName

Argumente

Begriff Definition
fileName Pfad der benutzerdefinierten Manifestdatei.

Hinweise

Standardmäßig bettet der Visual Basic-Compiler ein Anwendungsmanifest ein, das eine angeforderte Ausführungsebene als „asInvoker“ angibt. Er erstellt das Manifest in demselben Ordner, in dem die ausführbare Datei erstellt wird. Wenn Sie Visual Studio verwenden, ist dies in der Regel der Ordner „bin\Debug“ oder „bin\Release“. Wenn Sie ein benutzerdefiniertes Manifest bereitstellen möchten, z. B. um die angeforderte Ausführungsebene „highestAvailable“ oder „requireAdministrator“ anzugeben, verwenden Sie diese Option zur Angabe des Dateinamens.

Hinweis

Diese Option und die Option -win32resource schließen sich gegenseitig aus. Wenn Sie versuchen, beide Optionen in derselben Befehlszeile zu verwenden, wird ein Buildfehler angezeigt.

Eine Anwendung ohne Anwendungsmanifest, das eine angeforderte Anwendungsebene angibt, unterliegt der Datei- und Registrierungsvirtualisierung unter der Benutzerkontensteuerung in Windows Vista. Weitere Informationen über Virtualisierung finden Sie unter ClickOnce-Bereitstellung unter Windows Vista.

Die Anwendung unterliegt der Virtualisierung, wenn eine der folgenden Bedingungen erfüllt ist:

  1. Sie verwenden die Option -nowin32manifest und stellen in einem späteren Buildschritt oder als Teil einer Windows-Ressourcendatei (RES-Datei) kein Manifest bereit, indem Sie die Option -win32resource verwenden.

  2. Sie stellen ein benutzerdefiniertes Manifest bereit, das keine angeforderte Ausführungsebene angibt.

Visual Studio erstellt eine MANIFEST-Standarddatei und speichert sie zusammen mit der ausführbaren Datei in den Debug- oder Releaseverzeichnissen. Klicken Sie zum Anzeigen oder Bearbeiten der „app.manifest“-Standarddatei im Projekt-Designer auf der Registerkarte Anwendung auf UAC-Einstellungen anzeigen. Weitere Informationen finden Sie unter Application Page, Project Designer (Visual Basic).

Sie können das Anwendungsmanifest als benutzerdefinierten Postbuildschritt oder als Teil einer Win32-Ressourcendatei bereitstellen, indem Sie die Option -nowin32manifest verwenden. Verwenden Sie dieselbe Option, wenn Ihre Anwendung der Datei- oder Registrierungsvirtualisierung unter Windows Vista unterliegen soll. Dadurch wird verhindert, dass der Compiler ein Standardmanifest in der PE-Datei erstellt und einbettet.

Beispiel

Das folgende Beispiel zeigt das Standardmanifest, das der Visual Basic-Compiler in eine PE-Datei einfügt.

Hinweis

Der Compiler fügt einen Standardanwendungsnamen („MyApplication.app“) in die XML-Manifestdatei ein. Mit dieser Problemumgehung können Anwendungen unter Windows Server 2003 Service Pack 3 ausgeführt werden.

<?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" name="MyApplication.app"/>  
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">  
    <security>  
      <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">  
        <requestedExecutionLevel level="asInvoker"/>  
      </requestedPrivileges>  
    </security>  
  </trustInfo>  
</assembly>

Siehe auch