MIDL - задача
Является оболочкой для компилятора с языка MIDL (midl.exe). Дополнительные сведения см. в разделе Справочник по командной строке языка MIDL.
Параметры
Ниже приводятся параметры задачи MIDL. Большинство параметров задачи и некоторые наборы параметров соответствуют параметрам командной строки.
AdditionalIncludeDirectories
Необязательный параметр типа String[].
Добавляет каталог к списку каталогов, в которых производится поиск импортированных файлов IDL, в том числе файлов заголовков и файлов конфигурации приложений (ACF).
Дополнительные сведения см. в описании параметра /I в Справочнике по командной строке языка MIDL.
AdditionalOptions
Необязательный параметр String .
Список параметров командной строки. Например, /<параметр1> /<параметр2> /<параметрN>. Этот параметр используется для указания параметров командной строки, не представленных каким-либо другим параметром задачи MIDL.
Дополнительные сведения см. в разделе Справочник по командной строке языка MIDL.
ApplicationConfigurationMode
Необязательный параметр Boolean .
Если это значение
true
, то в IDL-файле разрешается использовать некоторые ключевые слова ACF.Дополнительные сведения см. в описании параметра /app_config в Справочнике по командной строке языка MIDL.
ClientStubFile
Необязательный параметр String .
Задает имя клиентского файла-заглушки для интерфейса RPC.
Дополнительные сведения см. в описании параметра /cstub в Справочнике по командной строке языка MIDL. См. также описание параметра ServerStubFile в этой таблице.
CPreprocessOptions
Необязательный параметр String .
Задает параметры, которые следует передать препроцессору C/C++. Укажите параметры препроцессора, разделенные пробелом. Ожидается параметр
/E
.Дополнительные сведения см. в описании параметра /cpp_opt в Справочнике по командной строке языка MIDL.
DefaultCharType
Необязательный параметр String .
Определяет тип символов по умолчанию, который должен использовать компилятор C при компиляции созданного кода.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки Со знаком /char signed Без знака /char unsigned ASCII /char ascii7 Дополнительные сведения см. в описании параметра /char в Справочнике по командной строке языка MIDL.
DllDataFileName
Необязательный параметр String .
Задает имя создаваемого файла dlldata для прокси-библиотеки.
Дополнительные сведения см. в описании параметра /dlldata в Справочнике по командной строке языка MIDL.
EnableErrorChecks
Необязательный параметр String .
Задает тип проверки ошибок, которую создаваемые заглушки должны осуществлять во время выполнения.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки нет /error none Разрешить настройку /error Все /error all Дополнительные сведения см. в описании параметра /error в Справочнике по командной строке языка MIDL.
ErrorCheckAllocations
Необязательный параметр Boolean .
Если это значение
true
, проверить ошибки нехватки памяти.Дополнительные сведения см. в описании параметра /error allocation в Справочнике по командной строке языка MIDL.
ErrorCheckBounds
Необязательный параметр Boolean .
Если это значение
true
, проверить совместимо-переменные и переменные массивы на соответствие требованиям к размеру передаваемых данных.Дополнительные сведения см. в описании параметра /error bounds_check в Справочнике по командной строке языка MIDL.
ErrorCheckEnumRange
Необязательный параметр Boolean .
Если это значение
true
, проверить допустимость значения перечисления.Дополнительные сведения см. в описании параметра /error enum в справке по командной строке (/?) для midl.exe.
ErrorCheckRefPointers
Необязательный параметр Boolean .
Если это значение
true
, проверить, что в клиентские заглушки не передаются пустые указатели.Дополнительные сведения см. в описании параметра /error ref в Справочнике по командной строке языка MIDL.
ErrorCheckStubData
Необязательный параметр Boolean .
Если это значение
true
, создается заглушка, которая перехватывает исключения демаршалинга на стороне сервера и передает их обратно клиенту.Дополнительные сведения см. в описании параметра /error stub_data в Справочнике по командной строке языка MIDL.
GenerateClientFiles
Необязательный параметр String .
Определяет, должен ли компилятор создавать исходные файлы C для интерфейса RPC на стороне клиента.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки нет /client none Заглушка /client stub Дополнительные сведения см. в описании параметра /client в Справочнике по командной строке языка MIDL.
GenerateServerFiles
Необязательный параметр String .
Определяет, должен ли компилятор создавать исходные файлы C для интерфейса RPC на стороне сервера.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки нет /server none Заглушка /server stub Дополнительные сведения см. в описании параметра /server в Справочнике по командной строке языка MIDL.
GenerateStublessProxies
Необязательный параметр Boolean .
Если это значение
true
, создаются полностью преобразованные заглушки вместе с прокси-серверами без заглушек для объектных интерфейсов.Дополнительные сведения см. в описании параметра /Oicf в Справочнике по командной строке языка MIDL.
GenerateTypeLibrary
Необязательный параметр Boolean .
Если это значение
true
, файл библиотеки типов (с расширением TLB) не создается.Дополнительные сведения см. в описании параметра /notlbf в Справочнике по командной строке языка MIDL.
HeaderFileName
Необязательный параметр String .
Определяет имя создаваемого заголовочного файла.
Дополнительные сведения см. в описании параметра /h или /header в Справочнике по командной строке языка MIDL.
IgnoreStandardIncludePath
Необязательный параметр Boolean .
Если это значение
true
, задача MIDL выполняет поиск только в тех каталогах, которые заданы ключом AdditionalIncludeDirectories, игнорируя текущий каталог и каталоги, указанные в переменной среды INCLUDE.Дополнительные сведения см. в описании параметра /no_def_idir в Справочнике по командной строке языка MIDL.
InterfaceIdentifierFileName
Необязательный параметр String .
Определяет имя файла идентификатора интерфейса для COM-интерфейса. При этом переопределяется имя по умолчанию, полученное путем добавления "_i.c" к имени файла IDL.
Дополнительные сведения см. в описании параметра /iid в Справочнике по командной строке языка MIDL.
LocaleID
Необязательный параметр типа int.
Определяет идентификатор языкового стандарта, позволяющий использовать международные символы во входных файлах, именах файлов и путях к каталогам. Укажите идентификатор языкового стандарта в виде десятичного числа.
Дополнительные сведения см. в описании параметра /lcidСправочнике по командной строке языка MIDL. Также см. раздел Идентификаторы языкового стандарта.
MkTypLibCompatible
Необязательный параметр Boolean .
Если это значение
true
, необходимо использовать формат входного файла, совместимый с mktyplib.exe версии 2.03.Дополнительные сведения см. в описании параметра /mktyplib203 в Справочнике по командной строке языка MIDL. См. также статью Синтаксис файла ODL на веб-сайте MSDN.
OutputDirectory
Необязательный параметр String .
Определяет каталог по умолчанию, в который задача MIDL записывает выходные файлы.
Дополнительные сведения см. в описании параметра /out в Справочнике по командной строке языка MIDL.
PreprocessorDefinitions
Необязательный параметр типа String[].
Задает одно или несколько определений. Это имя и необязательное значение для передачи в препроцессор C (аналогично директиве
#define
). Форма каждой директивы определения — имя [= значение].Дополнительные сведения см. в описании параметра /D в Справочнике по командной строке языка MIDL. См. также описание параметра UndefinePreprocessorDefinitions в этой таблице.
ProxyFileName
Необязательный параметр String .
Определяет имя прокси-файла интерфейса для COM-интерфейса.
Дополнительные сведения см. в описании параметра /proxy в Справочнике по командной строке языка MIDL.
RedirectOutputAndErrors
Необязательный параметр String .
Перенаправляет выходные данные, такие как сообщения об ошибках и предупреждения, со стандартного пути в указанный файл.
Дополнительные сведения см. в описании параметра /o в Справочнике по командной строке языка MIDL.
ServerStubFile
Необязательный параметр String .
Задает имя серверного файла-заглушки для интерфейса RPC.
Дополнительные сведения см. в описании параметра /sstub в Справочнике по командной строке языка MIDL. См. также описание параметра ClientStubFile в этой таблице.
Источник
Обязательный параметр
ITaskItem[]
.Задает список исходных файлов, разделенных пробелами.
StructMemberAlignment
Необязательный параметр String .
Задает выравнивание (уровень упаковки) структур в целевой системе.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки NotSet <none> 1 /Zp1 2 /Zp2 4 /Zp4 8 /Zp8 Дополнительные сведения см. в описании параметра /Zp в Справочнике по командной строке языка MIDL. Параметр /Zp эквивалентен параметру /pack и более старому параметру /align.
SuppressCompilerWarnings
Необязательный параметр Boolean .
Если это значение
true
, отменяются предупреждающие сообщения от задачи MIDL.Дополнительные сведения см. в описании параметра /no_warn в Справочнике по командной строке языка MIDL.
SuppressStartupBanner
Необязательный параметр
Boolean
.Если задано значение
true
, запрещается отображение сообщения о номере версии и авторских правах при запуске задачи.Дополнительные сведения см. в описании параметра /nologo в Справочнике по командной строке языка MIDL.
TargetEnvironment
Необязательный параметр String .
Определяет среду, в которой выполняется приложение.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки NotSet <none> Win32 /env win32 Itanium /env ia64 X64 /env x64 Дополнительные сведения см. в описании параметра /env в Справочнике по командной строке языка MIDL.
TrackerLogDirectory
Необязательный параметр
String
.Задает промежуточный каталог, в котором хранятся журналы отслеживания для этой задачи.
TypeLibFormat
Необязательный параметр String .
Определяет формат файла библиотеки типов.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки Новый формат /newtlb Старый формат /oldtlb Дополнительные сведения см. в описании параметра /newtlb и /oldtlb в Справочнике по командной строке языка MIDL.
TypeLibraryName
Необязательный параметр String .
Задает имя файла библиотеки типов.
Дополнительные сведения см. в описании параметра /tlb в Справочнике по командной строке языка MIDL.
UndefinePreprocessorDefinitions
Необязательный параметр типа String[].
Отменяет любые предыдущие определения имени, сделанные при передаче имени в препроцессор C (аналогично директиве
#undefine
). Укажите одно или несколько ранее определенных имен.Дополнительные сведения см. в описании параметра /U в Справочнике по командной строке языка MIDL. См. также описание параметра PreprocessorDefinitions в этой таблице.
ValidateAllParameters
Необязательный параметр
Boolean
.Если это значение
true
, создаются дополнительные сведения для проверки, которые используются при проведении проверок на целостность во время выполнения. Если это значениеfalse
, сведения для проверки не создаются.Дополнительные сведения см. в описании параметров /robust и /no_robust в Справочнике по командной строке языка MIDL.
WarnAsError
Необязательный параметр
Boolean
.Если этот параметр равен
true
, все предупреждения обрабатываются как ошибки.Если параметр задачи MIDL WarningLevel не определен, предупреждения на уровне, заданном по умолчанию (уровне 1), обрабатываются как ошибки.
Дополнительные сведения см. в описании параметра /WX в Справочнике по командной строке языка MIDL. См. также описание параметра WarningLevel в этой таблице.
WarningLevel
Необязательный параметр String .
Определяет серьезность (уровень) выдаваемых предупреждений. Если задан уровень 0, предупреждения не выдаются. В противном случае предупреждение выдается, если его уровень численно меньше или равен указанному значению.
Укажите одно из следующих значений, каждое из которых соответствует параметру командной строки.
Значение Параметр командной строки 0 /W0 1 /W1 2 /W2 3 /W3 4 /W4 Дополнительные сведения см. в описании параметра /W в Справочнике по командной строке языка MIDL. См. также описание параметра WarnAsError в этой таблице.