Tâche MIDL
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.
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.
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.
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.
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.
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.
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.
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.
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. |