Partilhar via

-win32manifest (Visual Basic)

  • Artigo

Identifica um arquivo de manifesto do aplicativo Win32 definido pelo usuário a ser incorporado no arquivo executável portátil (PE) de um projeto.

Sintaxe

-win32manifest: fileName

Argumentos

Termo Definição
fileName O caminho do arquivo de manifesto personalizado.

Observações

Por padrão, o compilador do Visual Basic incorpora um manifesto do aplicativo que especifica um nível de execução solicitado de asInvoker. Ele cria o manifesto na mesma pasta em que o arquivo executável é criado, normalmente a pasta bin\Debug ou bin\Release quando você usa o Visual Studio. Se desejar fornecer um manifesto personalizado, por exemplo, para especificar um nível de execução solicitado de highestAvailable ou requireAdministrator, use essa opção para especificar o nome do arquivo.

Nota

Esta opção e a opção -win32resource são mutuamente exclusivas. Se você tentar usar ambas as opções na mesma linha de comando, você receberá um erro de compilação.

Um aplicativo que não tenha nenhum manifesto de aplicativo que especifique um nível de execução solicitado estará sujeito à virtualização de arquivo/registro no recurso Controle de Conta de Usuário no Windows Vista. Para obter mais informações sobre virtualização, consulte Implantação do ClickOnce no Windows Vista.

Seu aplicativo estará sujeito à virtualização se uma das seguintes condições for verdadeira:

  1. Você usa a opção e não fornece um manifesto -nowin32manifest em uma etapa de compilação posterior ou como parte de um arquivo de recurso do Windows (.res) usando a -win32resource opção.

  2. Você fornece um manifesto personalizado que não especifica um nível de execução solicitado.

O Visual Studio cria um arquivo .manifest padrão e o armazena nos diretórios de depuração e liberação ao lado do arquivo executável. Você pode exibir ou editar o arquivo app.manifest padrão clicando em Exibir Configurações do UAC na guia Aplicativo no Designer de Projeto. Para obter mais informações, consulte Página de aplicativo, Project Designer (Visual Basic).

Você pode fornecer o manifesto do aplicativo como uma etapa pós-compilação personalizada ou como parte de um arquivo de recurso Win32 usando a -nowin32manifest opção. Use essa mesma opção se quiser que seu aplicativo esteja sujeito à virtualização de arquivo ou registro no Windows Vista. Isso impedirá que o compilador crie e incorpore um manifesto padrão no arquivo PE.

Exemplo

O exemplo a seguir mostra o manifesto padrão que o compilador do Visual Basic insere em um PE.

Nota

O compilador insere um nome de aplicativo padrão MyApplication.app no XML de manifesto. Esta é uma solução alternativa para permitir que os aplicativos sejam executados no 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>

Consulte também