Tâche MIDLMIDL task

Encapsule l’outil du compilateur MIDL (Microsoft Interface Definition Language), midl.exe.Wraps the Microsoft Interface Definition Language (MIDL) compiler tool, midl.exe. Pour plus d’informations, consultez Informations de référence sur la ligne de commande MIDL.For more information, see MIDL command-line reference.

ParamètresParameters

Le tableau ci-après décrit les paramètres de la tâche MIDL.The following describes the parameters of the MIDL task. La plupart des paramètres de tâche, et quelques ensembles de paramètres, correspondent à une option de ligne de commande.Most task parameters, and a few sets of parameters, correspond to a command-line option.

  • AdditionalIncludeDirectoriesAdditionalIncludeDirectories

    Paramètre String[] facultatif.Optional String[] parameter.

    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).Adds a directory to the list of directories that are searched for imported IDL files, included header files, and application configuration files (ACF).

    Pour plus d’informations, consultez l’option /I dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /I option in MIDL command-line reference.

  • AdditionalOptionsAdditionalOptions

    Paramètre String facultatif.Optional String parameter.

    Liste des options de ligne de commande.A list of command-line options. Par exemple, /<option1> /<option2> /<option#>.For example, /<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.Use this parameter to specify command-line options that are not represented by any other MIDL task parameter.

    Pour plus d’informations, consultez Informations de référence sur la ligne de commande MIDL.For more information, see MIDL command-line reference.

  • ApplicationConfigurationModeApplicationConfigurationMode

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, vous permet d’utiliser certains mots clés ACF dans le fichier IDL.If true, lets you use some ACF keywords in the IDL file.

    Pour plus d’informations, consultez l’option /app_config dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /app_config option in MIDL command-line reference.

  • ClientStubFileClientStubFile

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom du fichier stub client d’une interface RPC.Specifies the name of the client stub file for an RPC interface.

    Pour plus d’informations, consultez l’option /cstub dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /cstub option in MIDL command-line reference. Reportez-vous également au paramètre ServerStubFile de ce tableau.Also see the ServerStubFile parameter in this table.

  • CPreprocessOptionsCPreprocessOptions

    Paramètre String facultatif.Optional String parameter.

    Spécifie les options à transmettre au préprocesseur C/C++.Specifies options to pass to the C/C++ preprocessor. Spécifiez une liste d’options de préprocesseur séparées par des espaces.Specify a space-delimited list of preprocessor options.

    Pour plus d’informations, consultez l’option /cpp_opt dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /cpp_opt option in MIDL command-line reference.

  • DefaultCharTypeDefaultCharType

    Paramètre String facultatif.Optional String parameter.

    Spécifie le type de caractère par défaut que le compilateur C utilisera pour compiler le code généré.Specifies the default character type that the C compiler will use to compile the generated code.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    SignedSigned /char signed/char signed
    UnsignedUnsigned /char unsigned/char unsigned
    AsciiAscii /char ascii7/char ascii7

    Pour plus d’informations, consultez l’option /char dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /char option in MIDL command-line reference.

  • DllDataFileNameDllDataFileName

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom du fichier dlldata généré pour une DLL de proxy.Specifies the file name for the generated dlldata file for a proxy DLL.

    Pour plus d’informations, consultez l’option /dlldata dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /dlldata option in MIDL command-line reference.

  • EnableErrorChecksEnableErrorChecks

    Paramètre String facultatif.Optional String parameter.

    Spécifie le type de vérification des erreurs que les stubs générés exécutent au moment de l’exécution.Specifies the type of error checking that the generated stubs will perform at run time.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    AucunNone /error none/error none
    EnableCustomEnableCustom /error/error
    AllAll /error all/error all

    Pour plus d’informations, consultez l’option /error dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /error option in MIDL command-line reference.

  • ErrorCheckAllocationsErrorCheckAllocations

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, vérifie les erreurs de mémoire insuffisante.If true, check for out-of-memory errors.

    Pour plus d’informations, consultez l’option /error allocation dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /error allocation option in MIDL command-line reference.

  • ErrorCheckBoundsErrorCheckBounds

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, vérifie la taille des tableaux ouverts et variables par rapport aux spécifications de durée de transmission.If true, checks the size of conformant-varying and varying arrays against the transmission length specification.

    Pour plus d’informations, consultez l’option /error bounds_check dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /error bounds_check option in MIDL command-line reference.

  • ErrorCheckEnumRangeErrorCheckEnumRange

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, vérifie que les valeurs enum sont comprises dans une plage autorisée.If true, checks that enum values are in an allowable range.

    Pour plus d’informations, consultez l’option /error enum dans l’aide relative à la ligne de commande (/?) de midl.exe.For more information, see the /error enum option in command-line help (/?) for midl.exe.

  • ErrorCheckRefPointersErrorCheckRefPointers

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, vérifie qu’aucun pointeur de référence null n’a été transmis à des stubs clients.If true, check that no null reference pointers are passed to client stubs.

    Pour plus d’informations, consultez l’option /error ref dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /error ref option in MIDL command-line reference.

  • ErrorCheckStubDataErrorCheckStubData

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, génère un stub qui intercepte les exceptions d’unmarshaling côté serveur et les propage de nouveau vers le client.If true, generates a stub that catches unmarshaling exceptions on the server side and propagates them back to the 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.For more information, see the /error stub_data option in MIDL command-line reference.

  • GenerateClientFilesGenerateClientFiles

    Paramètre String facultatif.Optional String parameter.

    Spécifie si le compilateur génère les fichiers sources C côté client pour une interface RPC.Specifies whether the compiler generates client-side C source files for an RPC interface.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    AucunNone /client none/client none
    StubStub /client 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.For more information, see the /client option in MIDL command-line reference.

  • GenerateServerFilesGenerateServerFiles

    Paramètre String facultatif.Optional String parameter.

    Spécifie si le compilateur génère les fichiers sources C côté serveur pour une interface RPC.Specifies whether the compiler generates server-side C source files for an RPC interface.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    AucunNone /server none/server none
    StubStub /server 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.For more information, see the /server option in MIDL command-line reference.

  • GenerateStublessProxiesGenerateStublessProxies

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, génère des stubs entièrement interprétés avec des proxies sans stub pour les interfaces objet.If true, generates fully interpreted stubs together with stubless proxies for object interfaces.

    Pour plus d’informations, consultez l’option /Oicf dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /Oicf option in MIDL command-line reference.

  • GenerateTypeLibraryGenerateTypeLibrary

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si la valeur est true, aucun fichier bibliothèque de types (.tlb) n’est généré.If true, a type library (.tlb) file is not generated.

    Pour plus d’informations, consultez l’option /notlb dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /notlb option in MIDL command-line reference.

  • HeaderFileNameHeaderFileName

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom du fichier d’en-tête généré.Specifies the name of the generated header file.

    Pour plus d’informations, consultez l’option /h ou /header dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /h or /header option in MIDL command-line reference.

  • IgnoreStandardIncludePathIgnoreStandardIncludePath

    Paramètre booléen facultatif.Optional Boolean parameter.

    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.If true, the MIDL task searches only the directories specified by using the AdditionalIncludeDirectories switch, and ignores the current directory and the directories specified by the INCLUDE environment variable.

    Pour plus d’informations, consultez l’option /no_def_idir dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /no_def_idir option in MIDL command-line reference.

  • InterfaceIdentifierFileNameInterfaceIdentifierFileName

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom du fichier identificateur d’interface d’une interface COM.Specifies the name of the interface identifier file for a COM interface. Cette opération remplace le nom par défaut obtenu en ajoutant « _i.c » au nom de fichier IDL.This overrides the default name obtained by adding "_i.c" to the IDL file name.

    Pour plus d’informations, consultez l’option /iid dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /iid option in MIDL command-line reference.

  • LocaleIDLocaleID

    Paramètre Entier facultatif.Optional int parameter.

    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.Specifies the locale identifier that enables the use of international characters in input files, file names, and directory paths. Spécifiez un identificateur de paramètres régionaux décimaux.Specify a decimal locale identifier.

    Pour plus d’informations, consultez l’option /lcid dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /lcid option in MIDL command-line reference. Consultez également Identificateurs de paramètres régionaux.Also see Locale identifiers.

  • MkTypLibCompatibleMkTypLibCompatible

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si la valeur est true, requiert que le format du fichier d’entrée soit compatible avec mktyplib.exe version 2.03.If true, requires the format of the input file to be compatible with 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.For more information, see the /mktyplib203 option in MIDL command-line reference. Consultez également Syntaxe du fichier ODL sur le site web MSDN.Also, see ODL file syntax on the MSDN website.

  • OutputDirectoryOutputDirectory

    Paramètre String facultatif.Optional String parameter.

    Spécifie le répertoire par défaut dans lequel la tâche MIDL écrit les fichiers de sortie.Specifies the default directory where the MIDL task writes output files.

    Pour plus d’informations, consultez l’option /out dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /out option in MIDL command-line reference.

  • PreprocessorDefinitionsPreprocessorDefinitions

    Paramètre String[] facultatif.Optional String[] parameter.

    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.Specifies one or more defines; that is, a name and an optional value to be passed to the C preprocessor as if by a #define directive. Forme de chaque définition : name[=value].The form of each define is, name[=value].

    Pour plus d’informations, consultez l’option /D dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /D option in MIDL command-line reference. Reportez-vous également au paramètre UndefinePreprocessorDefinitions de ce tableau.Also, see the UndefinePreprocessorDefinitions parameter in this table.

  • ProxyFileNameProxyFileName

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom du fichier proxy d’une interface COM.Specifies the name of the interface proxy file for a COM interface.

    Pour plus d’informations, consultez l’option /proxy dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /proxy option in MIDL command-line reference.

  • RedirectOutputAndErrorsRedirectOutputAndErrors

    Paramètre String facultatif.Optional String parameter.

    Redirige le résultat, par exemple les messages d’erreur et les avertissements, de la sortie standard vers le fichier spécifié.Redirects output, such as error messages and warnings, from standard output to the specified file.

    Pour plus d’informations, consultez l’option /o dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /o option in MIDL command-line reference.

  • ServerStubFileServerStubFile

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom du fichier stub serveur d’une interface RPC.Specifies the name of the server stub file for an RPC interface.

    Pour plus d’informations, consultez l’option /sstub dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /sstub option in MIDL command-line reference. Reportez-vous également au paramètre ClientStubFile de ce tableau.Also, see the ClientStubFile parameter in this table.

  • SourceSource

    Paramètre ITaskItem[] requis.Required ITaskItem[] parameter.

    Spécifie la liste des fichiers sources séparés par des espaces.Specifies a list of source files separated by spaces.

  • StructMemberAlignmentStructMemberAlignment

    Paramètre String facultatif.Optional String parameter.

    Spécifie l’alignement (niveau de compression) des structures sur le système cible.Specifies the alignment (packing level) of structures in the target system.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    NotSetNotSet <aucune><none>
    11 /Zp1/Zp1
    22 /Zp2/Zp2
    44 /Zp4/Zp4
    88 /Zp8/Zp8

    Pour plus d’informations, consultez l’option /Zp dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /Zp option in MIDL command-line reference. L’option /Zp est équivalente à l’option /pack et à l’ancienne option /align.The /Zp option is equivalent to the /pack option and the older /align option.

  • SuppressCompilerWarningsSuppressCompilerWarnings

    Paramètre booléen facultatif.Optional Boolean parameter.

    Si true, supprime les messages d’avertissement de la tâche MIDL.If true, suppresses warning messages from the MIDL task.

    Pour plus d’informations, consultez l’option /no_warn dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /no_warn option in MIDL command-line reference.

  • SuppressStartupBannerSuppressStartupBanner

    Paramètre Boolean facultatif.Optional Boolean parameter.

    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.If true, prevents the display of the copyright and version number message when the task starts.

    Pour plus d’informations, consultez l’option /nologo dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /nologo option in MIDL command-line reference.

  • TargetEnvironmentTargetEnvironment

    Paramètre String facultatif.Optional String parameter.

    Spécifie l’environnement dans lequel l’application s’exécute.Specifies the environment in which the application runs.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    NotSetNotSet <aucune><none>
    Win32Win32 /env win32/env win32
    ItaniumItanium /env ia64/env ia64
    X64X64 /env 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.For more information, see the /env option in MIDL command-line reference.

  • TrackerLogDirectoryTrackerLogDirectory

    Paramètre String facultatif.Optional String parameter.

    Spécifie le répertoire intermédiaire dans lequel sont stockés les fichiers journaux de suivi de cette tâche.Specifies the intermediate directory where tracking logs for this task are stored.

  • TypeLibFormatTypeLibFormat

    Paramètre String facultatif.Optional String parameter.

    Spécifie le format du fichier bibliothèque de types.Specifies the format of the type library file.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    NewFormatNewFormat /newtlb/newtlb
    OldFormatOldFormat /oldtlb/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.For more information, see the /newtlb and /oldtlb options in MIDL command-line reference.

  • TypeLibraryNameTypeLibraryName

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom du fichier bibliothèque de types.Specifies the name of the type library file.

    Pour plus d’informations, consultez l’option /tlb dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /tlb option in MIDL command-line reference.

  • UndefinePreprocessorDefinitionsUndefinePreprocessorDefinitions

    Paramètre String[] facultatif.Optional String[] parameter.

    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.Removes any previous definition of a name by passing the name to the C preprocessor as if by a #undefine directive. Spécifiez un ou plusieurs noms définis précédemment.Specify one or more previously defined names.

    Pour plus d’informations, consultez l’option /U dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /U option in MIDL command-line reference. Reportez-vous également au paramètre PreprocessorDefinitions de ce tableau.Also, see the PreprocessorDefinitions parameter in this table.

  • ValidateAllParametersValidateAllParameters

    Paramètre Boolean facultatif.Optional Boolean parameter.

    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.If true, generates additional error-checking information that is used to perform integrity checks at run time. Si false, aucune information de vérification des erreurs n’est générée.If false, the error-checking information is not generated.

    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.For more information, see the /robust and /no_robust options in MIDL command-line reference.

  • WarnAsErrorWarnAsError

    Paramètre Boolean facultatif.Optional Boolean parameter.

    Si true, traite tous les avertissements comme des erreurs.If true, treats all warnings as errors.

    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.If the WarningLevel MIDL task parameter is not specified, warnings at the default level, level 1, are treated as errors.

    Pour plus d’informations, consultez l’option /WX dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /WX options in MIDL command-line reference. Reportez-vous également au paramètre WarningLevel de ce tableau.Also, see the WarningLevel parameter in this table.

  • WarningLevelWarningLevel

    Paramètre String facultatif.Optional String parameter.

    Spécifie la gravité (niveau d’avertissement) des avertissements à émettre.Specifies the severity (warning level) of warnings to emit. Aucun avertissement n’est émis pour la valeur 0.No warning is emitted for a value of 0. Un avertissement est émis si son niveau est numériquement inférieur ou égal à la valeur spécifiée.Otherwise, a warning is emitted if its warning level is numerically less than or equal to the specified value.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.Specify one of the following values, each of which corresponds to a command-line option.

    ValueValue Option de ligne de commandeCommand-line option
    00 /W0/W0
    11 /W1/W1
    22 /W2/W2
    33 /W3/W3
    44 /W4/W4

    Pour plus d’informations, consultez l’option /W dans la page Informations de référence sur la ligne de commande MIDL.For more information, see the /W option in MIDL command-line reference. Reportez-vous également au paramètre WarnAsError de ce tableau.Also, see the WarnAsError parameter in this table.

Voir aussiSee also

Informations de référence sur les tâchesTask reference