Partilhar via


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.