Поделиться через

Задача MIDL

  • Статья

Создает оболочку компилятора языка Microsoft Interface Definition Language (MIDL) — midl.exe. Дополнительные сведения см. в статье "Справочник по командной строке MIDL" на веб-сайте MSDN.

Параметры

В следующей таблице описаны параметры задачи MIDL. Большинство параметров задач (а также несколько наборов параметров) соответствуют какому-либо параметру командной строки.

Параметр

Описание

AdditionalIncludeDirectories

Необязательный параметр типа String[].

Добавляет каталог в список каталогов, в которых производится поиск импортированных файлов IDL, включая файлы заголовков и файлы конфигурации приложений (ACF-файлы).

Дополнительные сведения см. в описании параметра /I в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

AdditionalOptions

Необязательный параметр типа String.

Список параметров командной строки. Например, "/параметр1 /параметр2 /параметр#". Этот параметр используется для задания параметров командной строки, которые не представлены другими параметрами задачи MIDL.

Дополнительные сведения см. в статье "Справочник по командной строке MIDL" на веб-сайте MSDN.

ApplicationConfigurationMode

Необязательный параметр типа Boolean.

Если он имеет значение true, то это позволяет использовать некоторые ключевые слова ACF в IDL-файле.

Дополнительные сведения см. в описании параметра /app_config в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

ClientStubFile

Необязательный параметр типа String.

Задает имя клиентского файла заглушки для интерфейса RPC.

Дополнительные сведения см. в описании параметра /cstub в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. параметр ServerStubFile в этой таблице.

CPreprocessOptions

Необязательный параметр типа String.

Задает параметры для передачи в препроцессор C или C++. Укажите список разделенных пробелами параметров препроцессора.

Дополнительные сведения см. в описании параметра /cpp_opt в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

DefaultCharType

Необязательный параметр типа String.

Задает тип символа по умолчанию, который компилятор C будет использовать для компиляции созданного кода.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
Signed/char signed
Unsigned/char unsigned
Ascii/char ascii7

Дополнительные сведения см. в описании параметра /char в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

DllDataFileName

Необязательный параметр типа String.

Задает имя для созданного файла dlldata для библиотеки DLL прокси.

Дополнительные сведения см. в описании параметра /dlldata в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

EnableErrorChecks

Необязательный параметр типа String.

Задает тип проверки ошибок, которую созданные заглушки будут выполнять во время выполнения.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
None/error none
EnableCustom/error
All/error all

Дополнительные сведения см. в описании параметра /error в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

ErrorCheckAllocations

Необязательный параметр типа Boolean.

Если он имеет значение true, выполняется проверка на наличие ошибок, связанных с нехваткой памяти.

Дополнительные сведения см. в описании параметра /error allocation в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

ErrorCheckBounds

Необязательный параметр типа Boolean.

Если он имеет значение true, выполняется проверка совместимо-переменных массивов и переменных массивов по отношению к спецификации длины передачи.

Дополнительные сведения см. в описании параметра /error bounds_check в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

ErrorCheckEnumRange

Необязательный параметр типа Boolean.

Если он имеет значение true, выполняется проверка, находятся ли значения перечисления в разрешенном диапазоне.

Дополнительные сведения см. в описании параметра /error enum в справке командной строки (/?) для программы midl.exe.

ErrorCheckRefPointers

Необязательный параметр типа Boolean.

Если он имеет значение true, выполняется проверка того, что в клиентские заглушки не передаются указатели пустых ссылок.

Дополнительные сведения см. в описании параметра /error ref в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

ErrorCheckStubData

Необязательный параметр типа Boolean.

Если он имеет значение true, то создается заглушка, которая перехватывает немаршалируемые исключения на стороне сервера и распространяет их обратно клиенту.

Дополнительные сведения см. в описании параметра /error stub_data в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

GenerateClientFiles

Необязательный параметр типа String.

Указывает, создает ли компилятор исходные файлы C на стороне клиента для интерфейса RPC.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
None/client none
Stub/client stub

Дополнительные сведения см. в описании параметра /client в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

GenerateServerFiles

Необязательный параметр типа String.

Указывает, создает ли компилятор исходные файлы C на стороне сервера для интерфейса RPC.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
None/server none
Stub/server stub

Дополнительные сведения см. в описании параметра /server в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

GenerateStublessProxies

Необязательный параметр типа Boolean.

Если он имеет значение true, то для объектных интерфейсов создаются полностью интерпретируемые заглушки вместе с прокси без заглушек.

Дополнительные сведения см. в описании параметра /Oicf в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

GenerateTypeLibrary

Необязательный параметр типа Boolean.

Если он имеет значение true, файл библиотеки типов (TLB-файл) не создается.

Дополнительные сведения см. в описании параметра /notlb в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

HeaderFileName

Необязательный параметр типа String.

Задает имя создаваемого файла заголовка.

Дополнительные сведения см. в описании параметра /h или /header в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

IgnoreStandardIncludePath

Необязательный параметр типа Boolean.

Если он имеет значение true, то задача MIDL выполняет поиск только в каталогах, заданных с помощью параметра AdditionalIncludeDirectories, и игнорирует текущий каталог и каталоги, указанные переменной среды INCLUDE.

Дополнительные сведения см. в описании параметра /no_def_idir в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

InterfaceIdentifierFileName

Необязательный параметр типа String.

Задает имя файла идентификатора интерфейса для COM-интерфейса. Это переопределяет имя по умолчанию, полученное путем добавления "_i.c" к имени IDL-файла.

Дополнительные сведения см. в описании параметра /iid в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

LocaleID

Необязательный параметр типа int.

Задает код языка, который позволяет использование международных символов во входных файлах, именах файлов и путей к каталогам. Укажите код языка в виде десятичного числа.

Дополнительные сведения см. в описании параметра /lcid в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. статью "Коды языков, назначенные Microsoft" на веб-узле MSDN.

MkTypLibCompatible

Необязательный параметр типа Boolean.

Если он имеет значение true, то требуется формат входного файла, совместимый с программой mktyplib.exe версии 2.03.

Дополнительные сведения см. в описании параметра /mktyplib203 в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. статью "Синтаксис ODL-файлов" на веб-сайте MSDN.

OutputDirectory

Необязательный параметр типа String.

Задает каталог по умолчанию, в который задача MIDL записывает выходные файлы.

Дополнительные сведения см. в описании параметра /out в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

PreprocessorDefinitions

Необязательный параметр типа String[].

Задает одно или несколько определений; то есть имя и необязательное значение, которые должны быть переданы в препроцессор C, как с помощью директивы #define. Форма каждой директивы определения: имя[=значение].

Дополнительные сведения см. в описании параметра /D в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. параметр UndefinePreprocessorDefinitions в этой таблице.

ProxyFileName

Необязательный параметр типа String.

Задает имя файла прокси интерфейса для COM-интерфейса.

Дополнительные сведения см. в описании параметра /proxy в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

RedirectOutputAndErrors

Необязательный параметр типа String.

Перенаправляет выходные данные, такие как сообщения об ошибках и предупреждения, из стандартных выходных данных в указанный файл.

Дополнительные сведения см. в описании параметра /o в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

ServerStubFile

Необязательный параметр типа String.

Задает имя серверного файла заглушки для интерфейса RPC.

Дополнительные сведения см. в описании параметра /sstub в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. параметр ClientStubFile в этой таблице.

Source

Обязательный параметр типа ITaskItem[].

Задает список исходных файлов, разделенных пробелами.

StructMemberAlignment

Необязательный параметр типа String.

Задает выравнивание (уровень упаковки) структур в системе назначения.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
NotSet<отсутствует>
1/Zp1
2/Zp2
4/Zp4
8/Zp8

Дополнительные сведения см. в описании параметра /Zp в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Параметр /Zp эквивалентен параметру /pack и устаревшему параметру /align.

SuppressCompilerWarnings

Необязательный параметр типа Boolean.

Если он имеет значение true, то отменяются предупреждающие сообщения из задачи MIDL.

Дополнительные сведения см. в описании параметра /no_warn в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

SuppressStartupBanner

Необязательный параметр типа Boolean.

Если значение равно true, при запуске задачи не отображается сообщение об авторских правах и номере версии.

Дополнительные сведения см. в описании параметра /nologo в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

TargetEnvironment

Необязательный параметр типа String.

Указывает среду, в которой выполняется приложение.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
NotSet<отсутствует>
Win32/env win32
Itanium/env ia64
X64/env x64

Дополнительные сведения см. в описании параметра /env в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

TrackerLogDirectory

Необязательный параметр типа String.

Задает промежуточный каталог, в котором хранятся журналы отслеживания для этой задачи.

TypeLibFormat

Необязательный параметр типа String.

Задает формат файла библиотеки типов.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
NewFormat/newtlb
OldFormat/oldtlb

Дополнительные сведения см. в описании параметров /newtlb и /oldtlb в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

TypeLibraryName

Необязательный параметр типа String.

Задает имя файла библиотеки типов.

Дополнительные сведения см. в описании параметра /tlb в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

UndefinePreprocessorDefinitions

Необязательный параметр типа String[].

Удаляет все предыдущие определения имени путем передачи этого имени в препроцессор C, как если бы это делалось с помощью директивы #undefine. Укажите одно или несколько предварительно определенных имен.

Дополнительные сведения см. в описании параметра /U в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. параметр PreprocessorDefinitions в этой таблице.

ValidateAllParameters

Необязательный параметр типа Boolean.

Если он имеет значение true, то создаются дополнительные сведения проверки ошибок, используемые для проверок целостности во время выполнения. Если false, сведения проверки ошибок не создаются.

Дополнительные сведения см. в описании параметров /robust и /no_robust в "Справочнике по командной строке MIDL" на веб-сайте MSDN.

WarnAsError

Необязательный параметр типа Boolean.

Если этот параметр равен true, все предупреждения обрабатываются как ошибки.

Если параметр WarningLevel задачи MIDL не указан, предупреждения уровня 1, установленного по умолчанию, рассматриваются как ошибки.

Дополнительные сведения см. в описании параметров /WX в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. параметр WarningLevel в этой таблице.

WarningLevel

Необязательный параметр типа String.

Указывает серьезность выдаваемых предупреждений (порог предупреждений). Для значения 0 не выдается предупреждение. В противном случае выдается предупреждение, если его уровень численно меньше или равен указанному значению.

Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.

ЗначениеПараметр командной строки
0/W0
1/W1
2/W2
3/W3
4/W4

Дополнительные сведения см. в описании параметра /W в "Справочнике по командной строке MIDL" на веб-сайте MSDN. Также см. параметр WarnAsError в этой таблице.

См. также

Другие ресурсы

Справочные сведения о задачах MSBuild