Tarefa MIDL
Envolve a ferramenta de compilador Microsoft Interface Definition Language (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 do MIDL tarefa.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 uma pasta à lista de diretórios são pesquisados para arquivos importados de IDL, arquivos de cabeçalho incluídos e arquivos de configuração de aplicativo (ACF). Para obter mais informações, consulte o /I opção de "Referência de linha de comando MIDL" no MSDN site da Web. |
AdditionalOptions |
Opcional String parâmetro. Uma lista de opções de linha de comando.Por exemplo, "/option1 /option2 /option#".Use esse parâmetro para especificar opções de linha de comando que não são representadas por qualquer outro parâmetro de 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 usar 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" no 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" no MSDN site da Web.Consulte também o ServerStubFile parâmetro nesta tabela. |
CPreprocessOptions |
Opcional String parâmetro. Especifica opções para passar para C/C++ pré-processador.Especifica uma lista delimitada por espaço das opções de pré-processador. Para obter mais informações, consulte o /cpp_opt opção de "Referência de linha de comando MIDL" no MSDN site da Web. |
DefaultCharType |
Opcional String parâmetro. Especifica o tipo de caractere padrão do compilador c usará para compilar o código gerado. Especifique um dos seguintes valores, cada um dos quais corresponde 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" no MSDN site da Web. |
DllDataFileName |
Opcional String parâmetro. Especifica o nome de arquivo gerado dlldata arquivo de um DLL do proxy. Para obter mais informações, consulte o /dlldata opção de "Referência de linha de comando MIDL" no MSDN site da Web. |
EnableErrorChecks |
Opcional String parâmetro. Especifica o tipo de erro de verificação de stubs gerados irá executar em tempo de execução. Especifique um dos seguintes valores, cada um dos quais corresponde 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" no 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" no MSDN site da Web. |
ErrorCheckBounds |
Opcional Boolean parâmetro. Se true, verifica o tamanho de variação conformes e variadas matrizes de especificação de comprimento da transmissão. Para obter mais informações, consulte o /error bounds_check opção de "Referência de linha de comando MIDL" no MSDN site da Web. |
ErrorCheckEnumRange |
Opcional Boolean parâmetro. Se true, verifica se os valores de enum estão em um intervalo permitido. Para obter mais informações, consulte o /error enum opção de ajuda de linha de comando (/?) para midl.exe. |
ErrorCheckRefPointers |
Opcional Boolean parâmetro. Se true, seleção sem 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" no 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 para o cliente. Para obter mais informações, consulte o /error stub_data opção de "Referência de linha de comando MIDL" no 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. Especifique um dos seguintes valores, cada um dos quais corresponde 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" no 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. Especifique um dos seguintes valores, cada um dos quais corresponde 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" no 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" no MSDN site da Web. |
GenerateTypeLibrary |
Opcional Boolean parâmetro. Se true, um arquivo de tipo de biblioteca (. tlb) não é gerado. Para obter mais informações, consulte o /notlb opção de "Referência de linha de comando MIDL" no 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" no MSDN site da Web. |
IgnoreStandardIncludePath |
Opcional Boolean parâmetro. Se true, a tarefa MIDL procura 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" no MSDN site da Web. |
InterfaceIdentifierFileName |
Opcional String parâmetro. Especifica o nome do arquivo de identificador de interface para uma interface COM.Isso substitui o nome padrão obtido, adicionando "_i.c" ao nome do arquivo IDL. Para obter mais informações, consulte o /iid opção de "Referência de linha de comando MIDL" no 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 arquivos 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" no MSDN site da Web.Consulte também "Localidade IDs atribuídos 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" no 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" no MSDN site da Web. |
PreprocessorDefinitions |
Opcional String[] parâmetro. Especifica um ou mais define; Isto é, um nome e um valor opcional a ser passado para o pré-processador c como se por um #define diretiva.É a forma de definir cada, nome [= valor. Para obter mais informações, consulte o /D opção de "Referência de linha de comando MIDL" no MSDN site da Web.Consulte também o UndefinePreprocessorDefinitions parâmetro nesta tabela. |
ProxyFileName |
Opcional String parâmetro. Especifica o nome do arquivo 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" no MSDN site da Web. |
RedirectOutputAndErrors |
Opcional String parâmetro. Redireciona a saída, como 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" no MSDN site da Web. |
ServerStubFile |
Opcional String parâmetro. Especifica o nome do arquivo de stub de servidor para uma interface RPC. Para obter mais informações, consulte o /sstub opção de "Referência de linha de comando MIDL" no MSDN site da Web.Consulte também o ClientStubFile parâmetro nesta 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) de estruturas no sistema de destino. Especifique um dos seguintes valores, cada um dos quais corresponde 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" no MSDN site da Web.O /Zp opção é equivalente a /pack opção e o antigo /align opção. |
SuppressCompilerWarnings |
Opcional Boolean parâmetro. Se true, suprime mensagens de aviso de tarefa MIDL. Para obter mais informações, consulte o /no_warn opção de "Referência de linha de comando MIDL" no MSDN site da Web. |
SuppressStartupBanner |
Opcional Boolean parâmetro. Se true, impede a exibição da mensagem de número de versão e copyright quando a tarefa for iniciada. Para obter mais informações, consulte o /nologo opção de "Referência de linha de comando MIDL" no MSDN site da Web. |
TargetEnvironment |
Opcional String parâmetro. Especifica o ambiente no qual o aplicativo é executado. Especifique um dos seguintes valores, cada um dos quais corresponde 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" no MSDN site da Web. |
TrackerLogDirectory |
Opcional String parâmetro. Especifica o diretório intermediário onde são armazenados os logs de rastreamento para essa tarefa. |
TypeLibFormat |
Opcional String parâmetro. Especifica o formato do arquivo de biblioteca de tipo. Especifique um dos seguintes valores, cada um dos quais corresponde 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 de opções em "Referência de linha de comando MIDL" no MSDN Web site. |
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" no 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" no MSDN site da Web.Consulte também o PreprocessorDefinitions parâmetro nesta tabela. |
ValidateAllParameters |
Opcional Boolean parâmetro. Se true, gera informações adicionais de verificação de erro que são usadas para executar verificações de integridade em tempo de execução.Se false, as informações de verificação de erro não são geradas. Para obter mais informações, consulte o /robust e /no_robust de opções em "Referência de linha de comando MIDL" no MSDN Web site. |
WarnAsError |
Opcional Boolean parâmetro. Se true, trata todos os avisos como erros. Se o WarningLevel MIDL tarefa parâmetro não for especificado, o avisos no nível padrão, nível 1, são tratados como erros. Para obter mais informações, consulte o /WX de opções em "Referência de linha de comando MIDL" no MSDN Web site.Consulte também o WarningLevel parâmetro nesta tabela. |
WarningLevel |
Opcional String parâmetro. Especifica a gravidade (nível de aviso de) 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. Especifique um dos seguintes valores, cada um dos quais corresponde 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" no MSDN site da Web.Consulte também o WarnAsError parâmetro nesta tabela. |