Compartir a través de


MIDL (tarea)

Incluye la herramienta de compilador Lenguaje de definición de interfaz de Microsoft (MIDL), midl.exe.Para obtener más información, vea "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

Parámetros

En la siguiente tabla se describen los parámetros de la tarea MIDL.La mayoría de los parámetros de tarea, y algunos conjuntos de parámetros, corresponden a una opción de la línea de comandos.

Parámetro

Descripción

AdditionalIncludeDirectories

Parámetro String[] opcional.

Agrega un directorio a la lista de directorios que se buscan para archivos IDL importados, incluidos archivos de encabezado y archivos de configuración de aplicación (ACF).

Para obtener más información, vea la opción /I de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

AdditionalOptions

Parámetro String opcional.

Una lista de opciones de la línea de comandos.Por ejemplo, "/opción1 /opción2 /opción#".Utilice este parámetro para especificar opciones de la línea de comandos que no están representadas por ningún otro parámetro de tarea de MIDL.

Para obtener más información, vea "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

ApplicationConfigurationMode

Parámetro Boolean opcional.

Si es true, le permite utilizar algunas palabras clave ACF en el archivo IDL.

Para obtener más información, vea la opción /app_config de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

ClientStubFile

Parámetro String opcional.

Especifica el nombre del archivo de código auxiliar de cliente de una interfaz RPC.

Para obtener más información, vea la opción /cstub de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También vea el parámetro ServerStubFile de esta tabla.

CPreprocessOptions

Parámetro String opcional.

Especifica opciones para pasarlas al preprocesador de C/C++.Especifique una lista de opciones de preprocesador delimitada por espacios.

Para obtener más información, vea la opción /cpp_opt de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

DefaultCharType

Parámetro String opcional.

Especifica el tipo de caracteres predeterminado que el compilador de C utilizará para compilar el código generado.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Signed/char signed
Unsigned/char unsigned
Ascii/char ascii7

Para obtener más información, vea la opción /char de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

DllDataFileName

Parámetro String opcional.

Especifica el nombre de archivo del archivo dlldata generado para una DLL de proxy.

Para obtener más información, vea la opción /dlldata de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

EnableErrorChecks

Parámetro String opcional.

Especifica el tipo de comprobación de errores que los códigos auxiliares generados realizarán en tiempo de ejecución.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
None/error none
EnableCustom/error
All/error all

Para obtener más información, vea la opción /error de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

ErrorCheckAllocations

Parámetro Boolean opcional.

Si es true, compruebe los errores de falta de memoria.

Para obtener más información, vea la opción /error allocation de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

ErrorCheckBounds

Parámetro Boolean opcional.

Si es true, comprueba el tamaño de matrices variables y variables compatibles según la especificación de longitud de transmisión.

Para obtener más información, vea la opción /error bounds_check de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

ErrorCheckEnumRange

Parámetro Boolean opcional.

Si es true, comprueba que los valores de enumeración están en un intervalo permitido.

Para obtener más información, vea la opción /error enum de la Ayuda de la línea de comandos (/?) de midl.exe.

ErrorCheckRefPointers

Parámetro Boolean opcional.

Si es true, compruebe que ningún puntero de referencia nula se pasa a los códigos auxiliares del cliente.

Para obtener más información, vea la opción /error ref de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

ErrorCheckStubData

Parámetro Boolean opcional.

Si es true, genera un código auxiliar que detecta las excepciones de cálculo de referencias en el lado del servidor y las propaga de nuevo al cliente.

Para obtener más información, vea la opción /error stub_data de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

GenerateClientFiles

Parámetro String opcional.

Especifica si el compilador genera archivos de origen de C del lado del cliente para una interfaz RPC.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
None/client none
Stub/client stub

Para obtener más información, vea la opción /client de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

GenerateServerFiles

Parámetro String opcional.

Especifica si el compilador genera archivos de origen de C del lado del servidor para una interfaz RPC.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
None/server none
Stub/server stub

Para obtener más información, vea la opción /server de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

GenerateStublessProxies

Parámetro Boolean opcional.

Si es true, genera códigos auxiliares totalmente interpretados junto con servidores proxy sin código auxiliar para las interfaces de objeto.

Para obtener más información, vea la opción /Oicf de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

GenerateTypeLibrary

Parámetro Boolean opcional.

Si es true, no se genera un archivo de biblioteca de tipos (.tlb).

Para obtener más información, vea la opción /notlb de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

HeaderFileName

Parámetro String opcional.

Especifica el nombre del archivo de encabezado generado.

Para obtener más información, vea la opción /h o /header de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

IgnoreStandardIncludePath

Parámetro Boolean opcional.

Si es true, la tarea de MIDL solo busca en los directorios especificados utilizando el modificador AdditionalIncludeDirectories, y omite el directorio actual y los directorios especificados por la variable de entorno INCLUDE.

Para obtener más información, vea la opción /no_def_idir de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

InterfaceIdentifierFileName

Parámetro String opcional.

Especifica el nombre del archivo de identificador de interfaz de una interfaz COM.Esto invalida el nombre predeterminado obtenido agregando "_i.c" al nombre de archivo de IDL.

Para obtener más información, vea la opción /iid de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

LocaleID

Parámetro int opcional.

Especifica el Id. de configuración regional que habilita el uso de caracteres internacionales en archivos de entrada, nombres de archivo y rutas de directorio.Especifique un identificador de configuración regional decimal.

Para obtener más información, vea la opción /lcid de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También vea "Locale IDs Assigned by Microsoft" en MSDN.

MkTypLibCompatible

Parámetro Boolean opcional.

Si es true, exige que el formato del archivo de entrada sea compatible con mktyplib.exe versión 2.03.

Para obtener más información, vea la opción /mktyplib203 de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También, vea "ODL File Syntax" en el sitio web de MSDN.

OutputDirectory

Parámetro String opcional.

Especifica el directorio predeterminado donde la tarea de MIDL escribe los archivos de salida.

Para obtener más información, vea la opción /out de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

PreprocessorDefinitions

Parámetro String[] opcional.

Especifica uno o más defines; es decir, un nombre y un valor opcional que se van a pasar al preprocesador de C como si lo hiciera una directiva #define.El formato de cada "define" es, nombre[=valor].

Para obtener más información, vea la opción /D de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También, vea el parámetro UndefinePreprocessorDefinitions de esta tabla.

ProxyFileName

Parámetro String opcional.

Especifica el nombre del archivo de proxy de interfaz de una interfaz COM.

Para obtener más información, vea la opción /proxy de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

RedirectOutputAndErrors

Parámetro String opcional.

Redirige la salida, por ejemplo mensajes de error y advertencias, de la salida estándar al archivo especificado.

Para obtener más información, vea la opción /o de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

ServerStubFile

Parámetro String opcional.

Especifica el nombre del archivo de código auxiliar de servidor de una interfaz RPC.

Para obtener más información, vea la opción /sstub de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También, vea el parámetro ClientStubFile de esta tabla.

Source

Parámetro ITaskItem[] requerido.

Especifica una lista de archivos de origen separada por espacios.

StructMemberAlignment

Parámetro String opcional.

Especifica la alineación (el nivel de empaquetado) de las estructuras en el sistema de destino.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
NotSet<none>
1/Zp1
2/Zp2
4/Zp4
8/Zp8

Para obtener más información, vea la opción /Zp de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.El /Zp opción equivale a la /pack opción y la versión más antigua /align opción.

SuppressCompilerWarnings

Parámetro Boolean opcional.

Si es true, suprime los mensajes de advertencia de la tarea de MIDL.

Para obtener más información, vea la opción /no_warn de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

SuppressStartupBanner

Parámetro Boolean opcional.

Si es true, evita la presentación del copyright y del mensaje de número de versión cuando la tarea se inicia.

Para obtener más información, vea la opción /nologo de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

TargetEnvironment

Parámetro String opcional.

Especifica el entorno en el que la aplicación se ejecuta.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
NotSet<none>
Win32/env win32
Itanium/env ia64
X64/env x64

Para obtener más información, vea la opción /env de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

TrackerLogDirectory

Parámetro String opcional.

Especifica el directorio intermedio donde se almacenan los registros de seguimiento de esta tarea.

TypeLibFormat

Parámetro String opcional.

Especifica el formato del archivo de la biblioteca de tipos.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
NewFormat/newtlb
OldFormat/oldtlb

Para obtener más información, vea las opciones /newtlb y /oldtlb de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

TypeLibraryName

Parámetro String opcional.

Especifica el nombre del archivo de la biblioteca de tipos.

Para obtener más información, vea la opción /tlb de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

UndefinePreprocessorDefinitions

Parámetro String[] opcional.

Quita cualquier definición anterior de un nombre pasando el nombre al preprocesador de C como si lo hiciera una directiva #undefine.Especifique uno o más nombres definidos previamente.

Para obtener más información, vea la opción /U de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También, vea el parámetro PreprocessorDefinitions de esta tabla.

ValidateAllParameters

Parámetro Boolean opcional.

Si es true, genera información de comprobación de errores adicional que se utiliza para realizar comprobaciones de integridad en tiempo de ejecución.Si es false, no se genera la información de comprobación de errores.

Para obtener más información, vea las opciones /robust y /no_robust de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.

WarnAsError

Parámetro Boolean opcional.

Si es true, trata todas las advertencias como errores.

Si no se especifica el parámetro de tarea WarningLevel de MIDL, las advertencias del nivel predeterminado, el nivel 1, se tratan como errores.

Para obtener más información, vea las opciones /WX de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También, vea el parámetro WarningLevel de esta tabla.

WarningLevel

Parámetro String opcional.

Especifica la gravedad (nivel de advertencia) de las advertencias que se desea emitir.No se emite ninguna advertencia para un valor de 0.De lo contrario, se emite una advertencia si su nivel de advertencia es numéricamente menor o igual que el valor especificado.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
0/W0
1/W1
2/W2
3/W3
4/W4

Para obtener más información, vea la opción /W de la "Referencia de la línea de comandos de MIDL" en el sitio web de MSDN.También, vea el parámetro WarnAsError de esta tabla.

Vea también

Otros recursos

Referencia de tareas de MSBuild