Partager via

MIDL (tâche)

  • Article

Encapsule l’outil du compilateur MIDL (Microsoft Interface Definition Language), midl.exe. Pour plus d’informations, consultez Informations de référence sur la ligne de commande MIDL.

Paramètres

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

  • AdditionalIncludeDirectories

    Paramètre String[] facultatif.

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

    Pour plus d’informations, consultez l’option /I dans la page Informations de référence sur la ligne de commande MIDL.

  • AdditionalOptions

    Paramètre String facultatif.

    Liste des 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 un autre paramètre de tâche MIDL.

    Pour plus d’informations, consultez Informations de référence sur la ligne de commande MIDL.

  • ApplicationConfigurationMode

    Paramètre Boolean facultatif.

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

    Pour plus d’informations, consultez l’option /app_config dans la page Informations de référence sur la ligne de commande MIDL.

  • 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 la page Informations de référence sur la ligne de commande MIDL. Reportez-vous également au paramètre ServerStubFile de ce tableau.

  • CPreprocessOptions

    Paramètre String facultatif.

    Spécifie les options à transmettre au préprocesseur C/C++. Spécifiez une liste d’options de préprocesseur séparées par des espaces. Doit contenir l’option /E.

    Pour plus d’informations, consultez l’option /cpp_opt dans la page Informations de référence sur la ligne de commande MIDL.

  • 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 correspondant à une option de ligne de commande.

    Valeur Option de ligne de commande
    Signé /char signed
    Non signé /char unsigned
    Ascii /char ascii7

    Pour plus d’informations, consultez l’option /char dans la page Informations de référence sur la ligne de commande MIDL.

  • DllDataFileName

    Paramètre String facultatif.

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

    Pour plus d’informations, consultez l’option /dlldata dans la page Informations de référence sur la ligne de commande MIDL.

  • EnableErrorChecks

    Paramètre String facultatif.

    Spécifie le type de vérification des erreurs que les stubs générés exécutent au moment de l’exécution.

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

    Valeur Option de ligne de commande
    Aucun /error none
    EnableCustom /error
    Tout /error all

    Pour plus d’informations, consultez l’option /error dans la page Informations de référence sur la ligne de commande MIDL.

  • ErrorCheckAllocations

    Paramètre Boolean facultatif.

    Si true, vérifie les erreurs de mémoire insuffisante.

    Pour plus d’informations, consultez l’option /error allocation dans la page Informations de référence sur la ligne de commande MIDL.

  • ErrorCheckBounds

    Paramètre Boolean facultatif.

    Si true, vérifie la taille des tableaux ouverts et variables par rapport aux spécifications de durée de transmission.

    Pour plus d’informations, consultez l’option /error bounds_check dans la page Informations de référence sur la ligne de commande MIDL.

  • ErrorCheckEnumRange

    Paramètre Boolean facultatif.

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

    Pour plus d’informations, consultez l’option /error enum dans l’aide relative à la ligne de commande (/?) de midl.exe.

  • ErrorCheckRefPointers

    Paramètre Boolean facultatif.

    Si true, vérifie qu’aucun pointeur de référence null n’a été transmis à des stubs clients.

    Pour plus d’informations, consultez l’option /error ref dans la page Informations de référence sur la ligne de commande MIDL.

  • ErrorCheckStubData

    Paramètre Boolean facultatif.

    Si true, génère un stub qui intercepte les exceptions d’unmarshaling côté serveur et les propage de nouveau vers le client.

    Pour plus d’informations, consultez l’option /error stub_data dans la page Informations de référence sur la ligne de commande MIDL.

  • GenerateClientFiles

    Paramètre String facultatif.

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

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

    Valeur Option de ligne de commande
    Aucun /client none
    Stub /client stub

    Pour plus d’informations, consultez l’option /client dans la page Informations de référence sur la ligne de commande MIDL.

  • GenerateServerFiles

    Paramètre String facultatif.

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

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

    Valeur Option de ligne de commande
    Aucun /server none
    Stub /server stub

    Pour plus d’informations, consultez l’option /server dans la page Informations de référence sur la ligne de commande MIDL.

  • GenerateStublessProxies

    Paramètre Boolean facultatif.

    Si true, génère des stubs entièrement interprétés avec des proxies sans stub pour les interfaces objet.

    Pour plus d’informations, consultez l’option /Oicf dans la page Informations de référence sur la ligne de commande MIDL.

  • GenerateTypeLibrary

    Paramètre Boolean facultatif.

    Si la valeur est true, aucun fichier bibliothèque de types (.tlb) n’est généré.

    Pour plus d’informations, consultez l’option /notlb dans la page Informations de référence sur la ligne de commande MIDL.

  • 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 la page Informations de référence sur la ligne de commande MIDL.

  • IgnoreStandardIncludePath

    Paramètre Boolean facultatif.

    Si true, la tâche MIDL effectue des recherches uniquement dans les répertoires spécifiés à l’aide du commutateur AdditionalIncludeDirectories, et ignore le répertoire actuel ainsi que les répertoires spécifiés par la variable d’environnement INCLUDE.

    Pour plus d’informations, consultez l’option /no_def_idir dans la page Informations de référence sur la ligne de commande MIDL.

  • InterfaceIdentifierFileName

    Paramètre String facultatif.

    Spécifie le nom du fichier identificateur d’interface d’une interface COM. Cette opération remplace le nom par défaut obtenu en ajoutant « _i.c » au nom de fichier IDL.

    Pour plus d’informations, consultez l’option /iid dans la page Informations de référence sur la ligne de commande MIDL.

  • LocaleID

    Paramètre Entier facultatif.

    Spécifie l’identificateur de paramètres régionaux qui permet d’utiliser des caractères internationaux dans les fichiers d’entrée, les noms de fichier et les chemins d’accès aux répertoires. Spécifiez un identificateur de paramètres régionaux décimaux.

    Pour plus d’informations, consultez l’option /lcid dans la page Informations de référence sur la ligne de commande MIDL. Consultez également Identificateurs de paramètres régionaux.

  • MkTypLibCompatible

    Paramètre Boolean facultatif.

    Si la valeur est 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 la page Informations de référence sur la ligne de commande MIDL. Consultez également Syntaxe du fichier ODL sur le site web MSDN.

  • OutputDirectory

    Paramètre String facultatif.

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

    Pour plus d’informations, consultez l’option /out dans la page Informations de référence sur la ligne de commande MIDL.

  • PreprocessorDefinitions

    Paramètre String[] facultatif.

    Spécifie un ou plusieurs définitions, autrement dit, un nom et une valeur facultative à transmettre au préprocesseur C comme s’ils l’étaient par une directive #define. Forme de chaque définition : name[=value].

    Pour plus d’informations, consultez l’option /D dans la page Informations de référence sur la ligne de commande MIDL. Reportez-vous également au paramètre UndefinePreprocessorDefinitions de ce tableau.

  • ProxyFileName

    Paramètre String facultatif.

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

    Pour plus d’informations, consultez l’option /proxy dans la page Informations de référence sur la ligne de commande MIDL.

  • RedirectOutputAndErrors

    Paramètre String facultatif.

    Redirige le résultat, par exemple 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 la page Informations de référence sur la ligne de commande MIDL.

  • 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 la page Informations de référence sur la ligne de commande MIDL. Reportez-vous également au paramètre ClientStubFile de ce tableau.

  • Source

    Paramètre ITaskItem[] requis.

    Spécifie la liste des fichiers sources séparés par des espaces.

  • StructMemberAlignment

    Paramètre String facultatif.

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

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

    Valeur Option de ligne de commande
    NotSet <aucun>
    1 /Zp1
    2 /Zp2
    4 /Zp4
    8 /Zp8

    Pour plus d’informations, consultez l’option /Zp dans la page Informations de référence sur la ligne de commande MIDL. L’option /Zp est équivalente à l’option /pack et à l’ancienne option /align.

  • SuppressCompilerWarnings

    Paramètre Boolean facultatif.

    Si true, supprime les messages d’avertissement de la tâche MIDL.

    Pour plus d’informations, consultez l’option /no_warn dans la page Informations de référence sur la ligne de commande MIDL.

  • SuppressStartupBanner

    Paramètre Boolean facultatif.

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

    Pour plus d’informations, consultez l’option /nologo dans la page Informations de référence sur la ligne de commande MIDL.

  • 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 correspondant à une option de ligne de commande.

    Valeur Option de ligne de commande
    NotSet <aucun>
    Win32 /env win32
    Itanium /env ia64
    X64 /env x64

    Pour plus d’informations, consultez l’option /env dans la page Informations de référence sur la ligne de commande MIDL.

  • TrackerLogDirectory

    Paramètre String facultatif.

    Spécifie le répertoire intermédiaire dans lequel sont stockés les fichiers journaux de suivi de cette tâche.

  • 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 correspondant à une option de ligne de commande.

    Valeur Option de ligne de commande
    NewFormat /newtlb
    OldFormat /oldtlb

    Pour plus d’informations, consultez les options /newtlb et /oldtlb dans la page Informations de référence sur la ligne de commande MIDL.

  • TypeLibraryName

    Paramètre String facultatif.

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

    Pour plus d’informations, consultez l’option /tlb dans la page Informations de référence sur la ligne de commande MIDL.

  • UndefinePreprocessorDefinitions

    Paramètre String[] facultatif.

    Supprime toute définition précédente d’un nom en le transmettant au préprocesseur C comme si c’était par l’action d’une directive #undefine. Spécifiez un ou plusieurs noms définis précédemment.

    Pour plus d’informations, consultez l’option /U dans la page Informations de référence sur la ligne de commande MIDL. Reportez-vous également au paramètre PreprocessorDefinitions de ce tableau.

  • ValidateAllParameters

    Paramètre Boolean facultatif.

    Si true, génère des informations supplémentaires de vérification des erreurs qui permettent d’effectuer des contrôles d’intégrité au moment de l’exécution. Si false, aucune information de vérification des erreurs n’est générée.

    Pour plus d’informations, consultez les options /robust et /no_robust dans la page Informations de référence sur la ligne de commande MIDL.

  • WarnAsError

    Paramètre Boolean facultatif.

    Si true, traite tous les avertissements comme des erreurs.

    Si le paramètre de tâche MIDL WarningLevel n’est pas spécifié, les avertissements du niveau par défaut, le niveau 1, sont considérés comme des erreurs.

    Pour plus d’informations, consultez l’option /WX dans la page Informations de référence sur la ligne de commande MIDL. Reportez-vous également au paramètre WarningLevel de 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. Un avertissement est émis si son niveau est numériquement inférieur ou égal à la valeur spécifiée.

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

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

    Pour plus d’informations, consultez l’option /W dans la page Informations de référence sur la ligne de commande MIDL. Reportez-vous également au paramètre WarnAsError de ce tableau.

Voir aussi