Freigeben über


-win32manifest (Visual Basic)

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

Syntax

-win32manifest: fileName  

Argumente

Begriff Definition
fileName Der Pfad der benutzerdefinierten Manifestdatei.

Bemerkungen

Standardmäßig bettet der Visual Basic-Compiler ein Anwendungsmanifest ein, das eine angeforderte Ausführungsebene von asInvoker angibt. Es erstellt das Manifest im selben Ordner, in dem die ausführbare Datei erstellt wird, in der Regel der Ordner "bin\Debug" oder "bin\Release", wenn Sie Visual Studio verwenden. Wenn Sie ein benutzerdefiniertes Manifest angeben möchten, z. B. um eine angeforderte Ausführungsebene von "highestAvailable" oder "requireAdministrator" anzugeben, verwenden Sie diese Option, um den Namen der Datei anzugeben.

Hinweis

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

Eine Anwendung ohne Anwendungsmanifest, die eine angeforderte Ausführungsebene angibt, unterliegt der Datei-/Registrierungsvirtualisierung unter dem Feature "Benutzerkontensteuerung" in Windows Vista. Weitere Informationen zur Virtualisierung finden Sie unter ClickOnce-Bereitstellung unter Windows Vista.

Ihre Anwendung unterliegt der Virtualisierung, wenn eine der folgenden Bedingungen zutrifft:

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

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

Visual Studio erstellt eine Standardmanifestdatei und speichert sie zusammen mit der ausführbaren Datei in den Debug- und Releaseverzeichnissen. Sie können die Standarddatei "app.manifest" anzeigen oder bearbeiten, indem Sie auf der Registerkarte "Anwendung" im Project Designer auf "UAC-Einstellungen anzeigen" klicken. Weitere Informationen finden Sie auf der Anwendungsseite, Project Designer (Visual Basic).

Sie können das Anwendungsmanifest als benutzerdefinierten Schritt nach dem Build oder als Teil einer Win32-Ressourcendatei mithilfe der -nowin32manifest Option bereitstellen. 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 die PE-Datei erstellt und einbettet.

Beispiel

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

Hinweis

Der Compiler fügt einen Standardanwendungsnamen MyApplication.app in das Manifest-XML ein. Dies ist eine Problemumgehung, mit der Anwendungen unter Windows Server 2003 Service Pack 3 ausgeführt werden können.

<?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