Sintaxe geral da linha de comando MIDL
O compilador MIDL processa um arquivo IDL e um arquivo de configuração de aplicativo opcional (ACF) para gerar um conjunto de arquivos de saída. Os atributos especificados na lista de atributos de interface do arquivo IDL determinam se o compilador gera arquivos de origem para uma interface RPC ou para uma interface OLE personalizada.
Opções de comutação
midl [command-line-switch [switch-options]] filename
-
de opção de linha de comando
-
Especifica as opções de linha de comando do compilador MIDL. Os interruptores podem aparecer em qualquer sequência.
-
opções de comutação
-
Especifica as opções associadas a cada opção. As opções válidas são descritas na entrada de referência para cada switch de compilador MIDL.
-
nome do arquivo
-
Especifica o nome do arquivo IDL. Este arquivo geralmente tem a extensão .idl, mas pode ter outro ou nenhum.
Comentários
As listas a seguir mostram os nomes padrão dos arquivos gerados para um arquivo IDL chamado Name.idl. Você pode usar opções de linha de comando para substituir esses nomes padrão. Observe que o nome do arquivo IDL pode ter uma extensão diferente de .idl, ou nenhuma extensão.
Por padrão (ou seja, se a lista de atributos da interface não contiver o objeto ou atributo local), o compilador gerará os seguintes arquivos para uma interface RPC :
- Esboço do cliente (name_c.c)
- Stub do servidor (name_s.c)
- Arquivo de cabeçalho (name.h)
Quando o objeto atributo aparece na lista de atributos de interface, o compilador gera os seguintes arquivos para uma interface COM:
- Arquivo proxy de interface (name_p.c)
- Arquivo de cabeçalho da interface (name.h)
- Arquivo UUID da interface (name_I.c)
Quando o atributolocalaparece na lista de atributos da interface, o compilador gera apenas o arquivo de cabeçalho da interface, Name.h.
O compilador MIDL fornecido com o Microsoft RPC invoca o pré-processador C conforme necessário para processar o arquivo IDL. Ele não invoca automaticamente o compilador C para compilar arquivos gerados.
Observação
O compilador MIDL fornecido com o Microsoft RPC usa uma sintaxe de linha de comando diferente do compilador IDL DCE.
O compilador MIDL alterna /env, /server, /sstube /out afetam o arquivo de stub do servidor.
Começando com MIDL versão 6.0.359, a opção de linha de comando padrão para o compilador MIDL é /Oicf /robust. Para desativar /robust, especifique a opção /no_robust.
O arquivo de cabeçalho
O arquivo de cabeçalho contém definições de todos os tipos de dados e operações declaradas no arquivo IDL. O arquivo de cabeçalho deve ser incluído por todos os módulos de aplicativo que chamam as operações definidas, implementam as operações definidas ou manipulam os tipos definidos.
O compilador MIDL alterna /header e /out afetam o arquivo de cabeçalho.