Tarefa MIDL
Encapsula a ferramenta do compilador de linguagem de definição de Interface da Microsoft (MIDL), midl.exe. Para obter mais informações, consulte "Referência de linha de comando MIDL" sobre o MSDN site da Web.
Parâmetros
A tabela a seguir descreve os parâmetros da MIDL de tarefas. A maioria dos parâmetros da tarefa e alguns conjuntos de parâmetros, correspondem a uma opção de linha de comando.
Parâmetro |
Descrição |
|---|---|
AdditionalIncludeDirectories |
Opcional String[] parâmetro. Adiciona um diretório para a lista de pastas que serão pesquisados os arquivos importados de IDL, arquivos de cabeçalho incluído e arquivos de configuração do aplicativo (ACF). Para obter mais informações, consulte o /I opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
AdditionalOptions |
Opcional String parâmetro. Uma lista de opções de linha de comando. Por exemplo, "/option# de /option2 /option1". Use esse parâmetro para especificar as opções de linha de comando que não são representadas por qualquer outro parâmetro da tarefa MIDL. Para obter mais informações, consulte "Referência de linha de comando MIDL" sobre o MSDN site da Web. |
ApplicationConfigurationMode |
Opcional Boolean parâmetro. Se true, permite que você use algumas palavras-chave ACF no arquivo IDL. Para obter mais informações, consulte o /app_config opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
ClientStubFile |
Opcional String parâmetro. Especifica o nome do arquivo de stub de cliente para uma interface RPC. Para obter mais informações, consulte o /cstub opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. Consulte também o ServerStubFile parâmetro na tabela. |
CPreprocessOptions |
Opcional String parâmetro. Especifica opções para passar para o C/C++ pré-processador. Especifica uma lista delimitada por espaço das opções de pré-processamento. Para obter mais informações, consulte o /cpp_opt opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
DefaultCharType |
Opcional String parâmetro. Especifica o tipo de caractere padrão que o compilador c usará para compilar o código gerado. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
Signed/char signed
Unsigned/char unsigned
Ascii/char ascii7
Para obter mais informações, consulte o /char opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
DllDataFileName |
Opcional String parâmetro. Especifica o nome de arquivo para o gerado dlldata o arquivo para uma DLL do proxy. Para obter mais informações, consulte o /dlldata opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
EnableErrorChecks |
Opcional String parâmetro. Especifica o tipo de erro de verificação que os stubs gerados executará em tempo de execução. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
None/error none
EnableCustom/error
All/error all
Para obter mais informações, consulte o /error opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
ErrorCheckAllocations |
Opcional Boolean parâmetro. Se true, verifique se há erros de falta de memória. Para obter mais informações, consulte o /error allocation opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
ErrorCheckBounds |
Opcional Boolean parâmetro. Se true, que verifica o tamanho dos arrays variados de conformes e variação em relação a especificação de comprimento de transmissão. Para obter mais informações, consulte o /error bounds_check opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
ErrorCheckEnumRange |
Opcional Boolean parâmetro. Se true, que verifica se os valores de enumeração estão no intervalo permitido. Para obter mais informações, consulte o /error enum opção na Ajuda de linha de comando (/?) para midl.exe. |
ErrorCheckRefPointers |
Opcional Boolean parâmetro. Se true, verifique que nenhuma ponteiros de referência nula são passados para os stubs de cliente. Para obter mais informações, consulte o /error ref opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
ErrorCheckStubData |
Opcional Boolean parâmetro. Se true, gera um stub que captura exceções unmarshaling no lado do servidor e as propaga volta ao cliente. Para obter mais informações, consulte o /error stub_data opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
GenerateClientFiles |
Opcional String parâmetro. Especifica se o compilador gera arquivos de código-fonte c do lado do cliente para uma interface RPC. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
None/client none
Stub/client stub
Para obter mais informações, consulte o /client opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
GenerateServerFiles |
Opcional String parâmetro. Especifica se o compilador gera arquivos de código-fonte c do lado do servidor para uma interface RPC. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
None/server none
Stub/server stub
Para obter mais informações, consulte o /server opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
GenerateStublessProxies |
Opcional Boolean parâmetro. Se true, gera os stubs totalmente interpretados juntamente com proxies sem stub para interfaces de objeto. Para obter mais informações, consulte o /Oicf opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
GenerateTypeLibrary |
Opcional Boolean parâmetro. Se true, um arquivo de biblioteca (. tlb) do tipo não é gerado. Para obter mais informações, consulte o /notlb opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
HeaderFileName |
Opcional String parâmetro. Especifica o nome do arquivo de cabeçalho gerado. Para obter mais informações, consulte o /h ou /header opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
IgnoreStandardIncludePath |
Opcional Boolean parâmetro. Se true, a tarefa MIDL procura apenas os diretórios especificados usando o AdditionalIncludeDirectories Alternar e ignora o diretório atual e os diretórios especificados pela variável de ambiente INCLUDE. Para obter mais informações, consulte o /no_def_idir opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
InterfaceIdentifierFileName |
Opcional String parâmetro. Especifica o nome da arquivo de identificador de interface para uma interface COM. Isso substitui o nome padrão obtido, adicionando "_i.c" o nome do arquivo IDL. Para obter mais informações, consulte o /iid opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
LocaleID |
Opcional int parâmetro. Especifica o identificador de localidade que permite o uso de caracteres internacionais em arquivos de entrada, nomes de arquivo e caminhos de diretório. Especifique um identificador de localidade de decimal. Para obter mais informações, consulte o /lcid opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. Consulte também "Localidade IDs atribuído pelo Microsoft" no MSDN. |
MkTypLibCompatible |
Opcional Boolean parâmetro. Se true, requer o formato do arquivo de entrada para ser compatível com o mktyplib. exe versão 2.03. Para obter mais informações, consulte o /mktyplib203 opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. Além disso, consulte "Sintaxe do arquivo ODL" no site do MSDN. |
OutputDirectory |
Opcional String parâmetro. Especifica o diretório padrão onde a tarefa MIDL grava arquivos de saída. Para obter mais informações, consulte o /out opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
PreprocessorDefinitions |
Opcional String[] parâmetro. Especifica um ou mais define; ou seja, um nome e um valor opcional a ser passada para o pré-processador c como se por um #define diretiva. A forma de cada definir é, nome [= valor. Para obter mais informações, consulte o /D opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. Consulte também o UndefinePreprocessorDefinitions parâmetro na tabela. |
ProxyFileName |
Opcional String parâmetro. Especifica o nome do arquivo de proxy de interface para uma interface COM. Para obter mais informações, consulte o /proxy opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
RedirectOutputAndErrors |
Opcional String parâmetro. Redireciona a saída, como, por exemplo, mensagens de erro e avisos, de saída padrão para o arquivo especificado. Para obter mais informações, consulte o /o opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
ServerStubFile |
Opcional String parâmetro. Especifica o nome do arquivo de stub do servidor para uma interface RPC. Para obter mais informações, consulte o /sstub opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. Consulte também o ClientStubFile parâmetro na tabela. |
Source |
Obrigatório ITaskItem[] parâmetro. Especifica uma lista dos arquivos de origem separados por espaços. |
StructMemberAlignment |
Opcional String parâmetro. Especifica o alinhamento (nível de remessa) das estruturas no sistema de destino. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
NotSet<none>.
1/Zp1
2/Zp2
4/Zp4
8/Zp8
Para obter mais informações, consulte o /Zp opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. O /Zp opção é equivalente do /pack opção e legado /align opção. |
SuppressCompilerWarnings |
Opcional Boolean parâmetro. Se true, suprime as mensagens de aviso da tarefa de MIDL. Para obter mais informações, consulte o /no_warn opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
SuppressStartupBanner |
Opcional Boolean parâmetro. Se true, impede a exibição do número de versão e copyright mensagem quando inicia a tarefa. Para obter mais informações, consulte o /nologo opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
TargetEnvironment |
Opcional String parâmetro. Especifica o ambiente no qual o aplicativo é executado. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
NotSet<none>.
Win32/env win32
Itanium/env ia64
X64/env x64
Para obter mais informações, consulte o /env opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
TrackerLogDirectory |
Opcional String parâmetro. Especifica o diretório intermediário onde estão armazenados os logs de rastreamento para esta tarefa. |
TypeLibFormat |
Opcional String parâmetro. Especifica o formato do arquivo de biblioteca de tipo. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
NewFormat/newtlb
OldFormat/oldtlb
Para obter mais informações, consulte o /newtlb e /oldtlb Opções de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
TypeLibraryName |
Opcional String parâmetro. Especifica o nome do arquivo de biblioteca de tipo. Para obter mais informações, consulte o /tlb opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
UndefinePreprocessorDefinitions |
Opcional String[] parâmetro. Remove qualquer definição anterior de um nome, passando o nome para o pré-processador c como se por um #undefine diretiva. Especifique um ou mais nomes definidos anteriormente. Para obter mais informações, consulte o /U opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. Consulte também o PreprocessorDefinitions parâmetro na tabela. |
ValidateAllParameters |
Opcional Boolean parâmetro. Se true, gera informações de verificação de erros adicionais que são usadas para executar verificações de integridade em tempo de execução. Se false, as informações de verificação de erros não são geradas. Para obter mais informações, consulte o /robust e /no_robust Opções de "referência de linha de comando MIDL" sobre o MSDN site da Web. |
WarnAsError |
Opcional Boolean parâmetro. Se true, que trata todos os avisos como erros. Se o WarningLevel parâmetro da tarefa MIDL não for especificado, os avisos no nível padrão, o nível 1, são tratados como erros. Para obter mais informações, consulte o /WX Opções de "referência de linha de comando MIDL" sobre o MSDN site da Web. Consulte também o WarningLevel parâmetro na tabela. |
WarningLevel |
Opcional String parâmetro. Especifica a gravidade (o nível de aviso) de avisos para emitir. Nenhum aviso é emitido para um valor de 0. Caso contrário, um aviso é emitido se o seu nível de aviso é numericamente menor ou igual ao valor especificado. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.
ValorOpção de linha de comando
0/W0
1/W1
2/W2
3/W3
4/W4
Para obter mais informações, consulte o /W opção de "referência de linha de comando MIDL" sobre o MSDN site da Web. Consulte também o WarnAsError parâmetro na tabela. |