一般的な MIDL コマンド ライン構文

  • [アーティクル]

MIDL コンパイラは、IDL ファイルとオプションのアプリケーション構成ファイル (ACF) を処理して、一連の出力ファイルを生成します。 IDL ファイルのインターフェイス属性リストで指定された属性によって、コンパイラが RPC インターフェイスまたはカスタム OLE インターフェイスのソース ファイルを生成するかどうかが決まります。

スイッチ のオプション

     midl [command-line-switch [switch-options]] filename

command-line-switch

MIDL コンパイラのコマンド ライン スイッチを指定します。 スイッチは、任意の順序で表示できます。

switch-options

各スイッチに関連付けられているオプションを指定します。 有効なオプションについては、各 MIDL コンパイラー・スイッチの参照項目で説明します。

filename

IDL ファイルの名前を指定します。 通常、このファイルには拡張子 .idl がありますが、別のファイルまたはなしを使用できます。

解説

次の一覧は、Name.idl という名前の IDL ファイルに対して生成されるファイルの既定の名前を示しています。 コマンド ライン スイッチを使用して、これらの既定の名前をオーバーライドできます。 IDL ファイルの名前には、.idl 以外の拡張子を付けたり、拡張子をまったく指定したりすることはできません。

既定では (つまり、インターフェイス属性リストに オブジェクト または ローカル 属性が含まれていない場合)、コンパイラは RPC インターフェイス用に次のファイルを生成します。

  • クライアント スタブ (name_c.c)
  • サーバー スタブ (name_s.c)
  • ヘッダー ファイル (name.h)

オブジェクト属性がインターフェイス属性の一覧に表示されると、コンパイラは COM インターフェイスに対して次のファイルを生成します。

  • インターフェイス プロキシ ファイル (name_p.c)
  • インターフェイス ヘッダー ファイル (name.h)
  • インターフェイス UUID ファイル (name_I.c)

ローカル属性がインターフェイス属性リストに表示されると、コンパイラはインターフェイス ヘッダー ファイル Name.h のみを生成します。

Microsoft RPC で提供される MIDL コンパイラは、IDL ファイルを処理するために必要に応じて C プリプロセッサを呼び出します。 生成されたファイルをコンパイルするために C コンパイラを自動的に呼び出すわけではありません。

注意

Microsoft RPC で提供される MIDL コンパイラでは、DCE IDL コンパイラとは異なるコマンド ライン構文が使用されます。

 

MIDL コンパイラは、サーバー スタブ ファイルに影響を与える /env、 /server、 /sstub、および /out を切り替えます。

MIDL バージョン 6.0.359 以降、MIDL コンパイラの既定のコマンド ライン オプションは /OicfÂ/robust です。 /robust を無効にするには、 /no_robust オプションを指定します。

ヘッダー ファイル

ヘッダー ファイルには、IDL ファイルで宣言されているすべてのデータ型と操作の定義が含まれています。 ヘッダー ファイルは、定義された操作を呼び出す、定義された操作を実装する、または定義された型を操作するすべてのアプリケーション モジュールに含める必要があります。

MIDL コンパイラは /header と /out を切り替え、ヘッダー ファイルに影響します。