Partager via

Tâche MIDL

  • Article

Encapsule l'outil de compilateur Microsoft Interface Definition Language (MIDL), midl.exe.Pour plus d'informations, consultez « Référence de la ligne de commande MIDL » sur le site Web MSDN.

Paramètres

Le tableau suivant décrit les paramètres de la tâche MIDL.La plupart des paramètres de tâche, et quelques jeux de paramètres, correspondent à une option de ligne de commande.

Paramètre

Description

AdditionalIncludeDirectories

Paramètre String[] facultatif.

Ajoute un répertoire à la liste des répertoires dans lesquels sont recherchés des fichiers IDL importés, des fichiers d'en-tête inclus et des fichiers de configuration de l'application (ACF).

Pour plus d'informations, consultez l'option /I dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

AdditionalOptions

Paramètre String facultatif.

Liste d'options de ligne de commande.Par exemple, "/option1 /option2 /option#".Utilisez ce paramètre pour spécifier des options de ligne de commande qui ne sont pas représentées par tout autre paramètre de tâche MIDL.

Pour plus d'informations, consultez « Référence de la ligne de commande MIDL » sur le site Web MSDN.

ApplicationConfigurationMode

Paramètre Boolean facultatif.

Si true, vous permet d'utiliser des mots clés ACF dans le fichier IDL.

Pour plus d'informations, consultez l'option /app_config dans Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

ClientStubFile

Paramètre String facultatif.

Spécifie le nom du fichier stub client d'une interface RPC.

Pour plus d'informations, consultez l'option /cstub dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.Consultez également le paramètre ServerStubFile dans ce tableau.

CPreprocessOptions

Paramètre String facultatif.

Spécifie des options à passer au préprocesseur C/C++.Spécifiez une liste délimitée par des espaces d'options de préprocesseur.

Pour plus d'informations, consultez l'option /cpp_opt dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

DefaultCharType

Paramètre String facultatif.

Spécifie le type de caractère par défaut que le compilateur C utilisera pour compiler le code généré.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
Signed/char signed
Unsigned/char unsigned
Ascii/char ascii7

Pour plus d'informations, consultez l'option /char dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

DllDataFileName

Paramètre String facultatif.

Spécifie le nom du fichier dlldata généré pour une DLL proxy.

Pour plus d'informations, consultez l'option /dlldata dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

EnableErrorChecks

Paramètre String facultatif.

Spécifie le type de vérification d'erreurs que les stubs générés exécuteront au moment de l'exécution.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
None/error none
EnableCustom/error
All/error all

Pour plus d'informations, consultez l'option /error dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

ErrorCheckAllocations

Paramètre Boolean facultatif.

Si true, recherchez les erreurs de mémoire insuffisante.

Pour plus d'informations, consultez l'option /error allocation dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

ErrorCheckBounds

Paramètre Boolean facultatif.

Si true, vérifie la taille des tableaux qui varient par rapport à la spécification de longueur de transmission.

Pour plus d'informations, consultez l'option /error bounds_check dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

ErrorCheckEnumRange

Paramètre Boolean facultatif.

Si true, vérifie que les valeurs enum sont dans une plage autorisée.

Pour plus d'informations, consultez l'option /error enum dans l'aide de ligne de commande (/?) pour midl.exe.

ErrorCheckRefPointers

Paramètre Boolean facultatif.

Si true, vérifiez qu'aucun pointeur de référence null n'est passé aux stubs clients.

Pour plus d'informations, consultez l'option /error ref dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

ErrorCheckStubData

Paramètre Boolean facultatif.

Si true, génère un stub qui met en cache les exceptions démarshalées sur le côté serveur et les propage vers le client.

Pour plus d'informations, consultez l'option /error stub_data dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

GenerateClientFiles

Paramètre String facultatif.

Spécifie si le compilateur génère des fichiers sources C côté client pour une interface RPC.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
None/client none
Stub/client stub

Pour plus d'informations, consultez l'option /client dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

GenerateServerFiles

Paramètre String facultatif.

Spécifie si le compilateur génère des fichiers sources C côté serveur pour une interface RPC.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
None/server none
Stub/server stub

Pour plus d'informations, consultez l'option /server dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

GenerateStublessProxies

Paramètre Boolean facultatif.

Si true, génère des stubs interprétés pleinement avec les proxys sans stub pour les interfaces d'objet.

Pour plus d'informations, consultez l'option /Oicf dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

GenerateTypeLibrary

Paramètre Boolean facultatif.

Si true, un fichier de bibliothèque de types (.tlb) n'est pas généré.

Pour plus d'informations, consultez /notlb dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

HeaderFileName

Paramètre String facultatif.

Spécifie le nom du fichier d'en-tête généré.

Pour plus d'informations, consultez l'option /h ou /header dans « Référence de la Ligne de commande du MIDL » sur le site Web MSDN.

IgnoreStandardIncludePath

Paramètre Boolean facultatif.

Si true, la tâche MIDL recherche uniquement les répertoires spécifiés à l'aide du commutateur AdditionalIncludeDirectories et ignore le répertoire actif et les répertoires spécifiés par la variable d'environnement INCLUDE.

Pour plus d'informations, consultez l'option /no_def_idir dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

InterfaceIdentifierFileName

Paramètre String facultatif.

Spécifie le nom du fichier identificateur d'interface d'une interface COM.Cela substitue le nom par défaut obtenu en ajoutant « _i.c » au nom de fichier IDL.

Pour plus d'informations, consultez l'option /iid dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

LocaleID

Paramètre int facultatif.

Spécifie l'identificateur de paramètres régionaux qui permet l'utilisation de caractères internationaux dans les fichiers d'entrée, les noms de fichiers et les chemins d'accès au répertoire.Spécifiez un identificateur de paramètres régionaux décimal.

Pour plus d'informations, consultez l'option /lcid dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.Consultez également « ID de paramètres régionaux assignés par Microsoft » sur MSDN.

MkTypLibCompatible

Paramètre Boolean facultatif.

Si true, requiert que le format du fichier d'entrée soit compatible avec mktyplib.exe version 2.03.

Pour plus d'informations, consultez l'option /mktyplib203 dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.De plus, consultez « Syntaxe du fichier ODL » sur le site Web MSDN.

OutputDirectory

Paramètre String facultatif.

Spécifie le répertoire par défaut où la tâche MIDL écrit les fichiers de sortie.

Pour plus d'informations, consultez l'option /out dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

PreprocessorDefinitions

Paramètre String[] facultatif.

Spécifie une ou plusieurs définitions, autrement dit un nom et une valeur facultative à passer au préprocesseur C comme si une directive #define était utilisée.Chaque définition se présente sous la forme nom[=valeur].

Pour plus d'informations, consultez l'option /D dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.Consultez également le paramètre UndefinePreprocessorDefinitions dans ce tableau.

ProxyFileName

Paramètre String facultatif.

Spécifie le nom du fichier proxy d'interface d'une interface COM.

Pour plus d'informations, consultez /proxy dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

RedirectOutputAndErrors

Paramètre String facultatif.

Redirige la sortie, telle que les messages d'erreur et les avertissements, de la sortie standard vers le fichier spécifié.

Pour plus d'informations, consultez l'option /o dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

ServerStubFile

Paramètre String facultatif.

Spécifie le nom du fichier stub serveur d'une interface RPC.

Pour plus d'informations, consultez l'option /sstub dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.Consultez également le paramètre ClientStubFile dans ce tableau.

Source

Paramètre ITaskItem[] obligatoire.

Spécifie une liste de fichiers sources séparés par des espaces.

StructMemberAlignment

Paramètre String facultatif.

Spécifie l'alignement (niveau de compression) des structures dans le système cible.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
NotSet<aucune>
1/Zp1
2/Zp2
4/Zp4
8/Zp8

Pour plus d'informations, consultez l'option /Zp dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.Le /Zp option est équivalente à la /pack option et l'ancien /align option.

SuppressCompilerWarnings

Paramètre Boolean facultatif.

Si true, supprime des messages d'avertissement de la tâche MIDL.

Pour plus d'informations, consultez l'option /no_warn dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

SuppressStartupBanner

Paramètre Boolean facultatif.

Si true, empêche l'affichage du copyright et du numéro de version lorsque la tâche démarre.

Pour plus d'informations, consultez l'option /nologo dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

TargetEnvironment

Paramètre String facultatif.

Spécifie l'environnement dans lequel l'application s'exécute.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
NotSet<aucune>
Win32/env win32
Itanium/env ia64
X64/env x64

Pour plus d'informations, consultez l'option /env dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

TrackerLogDirectory

Paramètre String facultatif.

Spécifie le répertoire intermédiaire où les journaux de Tracker de cette tâche sont stockés.

TypeLibFormat

Paramètre String facultatif.

Spécifie le format du fichier bibliothèque de types.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
NewFormat/newtlb
OldFormat/oldtlb

Pour plus d'informations, consultez les options /newtlb et /oldtlb dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

TypeLibraryName

Paramètre String facultatif.

Spécifie le nom du fichier bibliothèque de types.

Pour plus d'informations, consultez l'option /tlb dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

UndefinePreprocessorDefinitions

Paramètre String[] facultatif.

Supprime toute définition précédente d'un nom en passant ce dernier au préprocesseur C comme si une directive #undefine était utilisée.Spécifiez un ou plusieurs noms définis précédemment.

Pour plus d'informations, consultez l'option /U dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.Consultez également le paramètre PreprocessorDefinitions dans ce tableau.

ValidateAllParameters

Paramètre Boolean facultatif.

Si true, génère des informations de contrôle des erreurs supplémentaires utilisées pour exécuter des contrôles d'intégrité au moment de l'exécution.Si false, les informations de contrôle d'erreurs ne sont pas générées.

Pour plus d'informations, consultez les options /robust et /no_robust dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.

WarnAsError

Paramètre Boolean facultatif.

Si la valeur est true, considère tous les avertissements comme des erreurs.

Si le paramètre de la tâche MIDL WarningLevel n'est pas spécifié, des avertissements au niveau par défaut, niveau 1, sont traités comme erreurs.

Pour plus d'informations, consultez les options /WX dans la « Référence de la Ligne de commande du MIDL » sur le site Web MSDN.Consultez également le paramètre WarningLevel dans ce tableau.

WarningLevel

Paramètre String facultatif.

Spécifie la gravité (niveau d'avertissement) des avertissements à émettre.Aucun avertissement n'est émis pour la valeur 0.Sinon, un avertissement est émis dans le cas où son niveau d'avertissement est numériquement inférieur ou égal à la valeur spécifiée.

Spécifiez l'une des valeurs suivantes, chacune d'elles correspond à une option de ligne de commande.

ValeurOption de ligne de commande
0/W0
1/W1
2/W2
3/W3
4/W4

Pour plus d'informations, consultez l'option /W dans « Référence de la ligne de commande MIDL » (page éventuellement en anglais) sur le site Web MSDN.Consultez également le paramètre WarnAsError dans ce tableau.

Voir aussi

Autres ressources

Référence des tâches MSBuild