Syntaxe de ligne de commande MIDL générale

  • Article

Le compilateur MIDL traite un fichier IDL et un fichier de configuration d’application facultatif (ACF) pour générer un ensemble de fichiers de sortie. Les attributs spécifiés dans la liste des attributs d’interface du fichier IDL déterminent si le compilateur génère des fichiers sources pour une interface RPC ou pour une interface OLE personnalisée.

Options de commutateur

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

commutateur de ligne de commande

Spécifie les commutateurs de ligne de commande du compilateur MIDL. Les commutateurs peuvent apparaître dans n’importe quelle séquence.

switch-options

Spécifie les options associées à chaque commutateur. Les options valides sont décrites dans l’entrée de référence pour chaque commutateur de compilateur MIDL.

Fichier

Spécifie le nom du fichier IDL. Ce fichier a généralement l’extension .idl, mais il peut en avoir une autre ou aucune.

Notes

Les listes suivantes affichent les noms par défaut des fichiers générés pour un fichier IDL nommé Name.idl. Vous pouvez utiliser des commutateurs de ligne de commande pour remplacer ces noms par défaut. Notez que le nom du fichier IDL peut avoir une extension autre que .idl, ou aucune extension du tout.

Par défaut (autrement dit, si la liste des attributs d’interface ne contient pas l’objet ou l’attribut local ), le compilateur génère les fichiers suivants pour une interface RPC :

  • Stub client (name_c.c)
  • Stub du serveur (name_s.c)
  • Fichier d’en-tête (name.h)

Lorsque l’attribut d’objet apparaît dans la liste des attributs d’interface, le compilateur génère les fichiers suivants pour une interface COM :

  • Fichier proxy d’interface (name_p.c)
  • Fichier d’en-tête d’interface (name.h)
  • Fichier UUID d’interface (name_I.c)

Lorsque l’attribut local apparaît dans la liste des attributs d’interface, le compilateur génère uniquement le fichier d’en-tête d’interface, Name.h.

Le compilateur MIDL fourni avec Microsoft RPC appelle le préprocesseur C en fonction des besoins pour traiter le fichier IDL. Il n’appelle pas automatiquement le compilateur C pour compiler les fichiers générés.

Notes

Le compilateur MIDL fourni avec Microsoft RPC utilise une syntaxe de ligne de commande différente de celle du compilateur IDL DCE.

 

Les commutateurs /env, /server, /sstub et /out du compilateur MIDL affectent le fichier stub du serveur.

À compter de MIDL version 6.0.359, l’option de ligne de commande par défaut du compilateur MIDL est /Oicf /robust. Pour désactiver /robust, spécifiez l’option /no_robust .

Fichier d’en-tête

Le fichier d’en-tête contient des définitions de tous les types de données et opérations déclarés dans le fichier IDL. Le fichier d’en-tête doit être inclus par tous les modules d’application qui appellent les opérations définies, implémentent les opérations définies ou manipulent les types définis.

Les commutateurs /header et /out du compilateur MIDL affectent le fichier d’en-tête.