Syntaxe générale de ligne de commande MIDL

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 d’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
    

de 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 du compilateur MIDL.

nom de fichier

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

Remarques

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 d’attributs d’interface ne contient pas l’objet ou 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’objet apparaît dans la liste des attributs de l’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’attributlocalapparaî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 si nécessaire pour traiter le fichier IDL. Il n’appelle pas automatiquement le compilateur C pour compiler des fichiers générés.

Le compilateur MIDL bascule /env, /server, /sstubet /out affecter le fichier stub du serveur.

À compter de MIDL version 6.0.359, l’option de ligne de commande par défaut pour le compilateur MIDL est /Marshalf /robuste. 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.

Le compilateur MIDL bascule /header et /out affecter le fichier d’en-tête.