-win32manifest (Visual Basic)
Identifica um arquivo de manifesto do aplicativo Win32 definido pelo usuário para ser inserido em um arquivo PE de um projeto.
Sintaxe
-win32manifest: fileName
Argumentos
Termo | Definição |
---|---|
fileName |
O caminho do arquivo de manifesto personalizado. |
Comentários
Por padrão, o compilador do Visual Basic insere um manifesto do aplicativo que especifica o nível de execução solicitado asInvoker. Ele cria o manifesto na mesma pasta em que o arquivo executável é compilado, normalmente a pasta bin\Debug ou bin\Release quando você usa o Visual Studio. Se você quiser fornecer um manifesto personalizado, por exemplo, para especificar um nível de execução solicitado de highestAvailable ou requireAdministrator, use esta opção para especificar o nome do arquivo.
Observação
Essa 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ê obterá um erro de build.
Um aplicativo que não tem nenhum manifesto do aplicativo que especifica que um nível de execução solicitado estará sujeito à virtualização de arquivos/Registro sob o recurso de Controle de Conta de Usuário no Windows Vista. Para saber mais sobre virtualização, confira Implantação do ClickOnce no Windows Vista.
Seu aplicativo estará sujeito à virtualização se alguma das condições a seguir for verdadeira:
Você usa a opção
-nowin32manifest
e não fornece um manifesto em uma etapa de build posterior ou como parte de um arquivo de Recurso (.res) do Windows usando a opção-win32resource
.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 juntamente com o 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, Designer de Projeto (Visual Basic).
Você pode fornecer o manifesto do aplicativo como uma etapa de pós-build personalizada ou como parte de um arquivo de recurso Win32 usando a opção -nowin32manifest
. Use essa mesma opção se quiser que o aplicativo seja sujeito à virtualização de arquivo ou Registro no Windows Vista. Isso impedirá que o compilador crie e insira 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.
Observação
O compilador insere um nome de aplicativo padrão MyApplication no XML do manifesto. Essa é uma solução alternativa para habilitar os aplicativos para serem 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>