Partager via

-win32manifest (Visual Basic)

  • Article

Identifie un fichier manifeste d'application Win32 défini par l'utilisateur à incorporer dans le fichier exécutable portable (PE) d'un projet.

Syntaxe

-win32manifest: fileName

Arguments

Terme Définition
fileName Chemin du fichier manifeste personnalisé.

Notes

Par défaut, le compilateur Visual Basic incorpore un manifeste d’application qui spécifie le niveau d’exécution requis « asInvoker ». Il crée le manifeste dans le même dossier que celui dans lequel l’exécutable est généré, normalement le dossier bin\Debug ou bin\Release quand vous utilisez Visual Studio. Pour fournir un manifeste personnalisé, par exemple pour spécifier le niveau d’exécution requis « highestAvailable » ou « requireAdministrator », utilisez cette option pour indiquer le nom du fichier.

Notes

Cette option et l’option win32resource s’excluent mutuellement. Si vous tentez d’utiliser ces deux options dans la même ligne de commande, une erreur de build se produira.

Une application sans manifeste d’application pour spécifier le niveau d’exécution requis est soumise à une virtualisation des fichiers/registres sous la fonctionnalité de contrôle de compte d’utilisateur de Windows Vista. Pour plus d’informations sur la virtualisation, consultez Déploiement ClickOnce sur Windows Vista.

Votre application sera soumise à la virtualisation si l’une de ces conditions est vérifiée :

  1. Vous utilisez l’option -nowin32manifest sans fournir de manifeste au cours d’une étape de génération ultérieure ou en tant que partie du fichier de ressources Windows (.res) à l’aide de l’option -win32resource.

  2. Vous fournissez un manifeste personnalisé qui ne spécifie pas le niveau d’exécution requis.

Visual Studio crée un fichier .manifest par défaut et le stocke dans les répertoires de débogage et de mise en production avec le fichier exécutable. Vous pouvez afficher ou modifier le fichier app.manifest par défaut en cliquant sur Afficher les paramètres UAC sous l’onglet Application du concepteur de projet. Pour plus d'informations, consultez Application Page, Project Designer (Visual Basic).

Vous pouvez fournir le manifeste de l’application en tant qu’étape après génération personnalisée ou en tant que partie d’un fichier de ressources Win32 à l’aide de l’option -nowin32manifest. Utilisez cette même option pour que votre application soit soumise à la virtualisation des fichiers ou des registres dans Windows Vista. Cela empêche le compilateur de créer et d’incorporer un manifeste par défaut dans le fichier PE.

Exemple

L’exemple suivant présente le manifeste par défaut que le compilateur Visual Basic insère dans un fichier PE.

Notes

Le compilateur ajoute un nom d’application standard « MyApplication.app » au manifeste xml. Cela permet aux applications de s’exécuter dans Windows Server 2003 Service Pack 3.

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

Voir aussi