MIDL — Zadanie
Opakowuje narzędzie kompilatora języka MICROSOFT Interface Definition Language (MIDL), midl.exe. Aby uzyskać więcej informacji, zobacz dokumentacja wiersza polecenia MIDL.
Parametry
Poniżej opisano parametry zadania MIDL . Większość parametrów zadania i kilka zestawów parametrów odpowiada opcji wiersza polecenia.
AdditionalIncludeDirectories
Opcjonalny parametr String[] .
Dodaje katalog do listy katalogów, które są wyszukiwane pod kątem zaimportowanych plików IDL, dołączonych plików nagłówków i plików konfiguracji aplikacji (ACF).
Aby uzyskać więcej informacji, zobacz /I opcja w dokumentacji wiersza polecenia MIDL.
Dodatkoweopcje
Opcjonalny parametr ciągu .
Lista opcji wiersza polecenia. Na przykład /<option1> /<option2> /<option#>. Użyj tego parametru, aby określić opcje wiersza polecenia, które nie są reprezentowane przez żaden inny parametr zadania MIDL.
Aby uzyskać więcej informacji, zobacz dokumentacja wiersza polecenia MIDL.
ApplicationConfigurationMode
Opcjonalny parametr logiczny .
Jeśli
trueparametr umożliwia użycie niektórych słów kluczowych ACF w pliku IDL.Aby uzyskać więcej informacji, zobacz /app_config opcja w dokumentacji wiersza polecenia MIDL.
ClientStubFile
Opcjonalny parametr ciągu .
Określa nazwę pliku wycinkowego klienta dla interfejsu RPC.
Aby uzyskać więcej informacji, zobacz /cstub opcja w dokumentacji wiersza polecenia MIDL. Zobacz również parametr ServerStubFile w tej tabeli.
CPreprocessOptions
Opcjonalny parametr ciągu .
Określa opcje przekazywania do preprocesora C/C++. Określ rozdzielaną spacją listę opcji preprocesora. Musi zawierać
/Eopcję .Aby uzyskać więcej informacji, zobacz /cpp_opt opcja w dokumentacji wiersza polecenia MIDL.
DefaultCharType
Opcjonalny parametr ciągu .
Określa domyślny typ znaku używany przez kompilator języka C do skompilowania wygenerowanego kodu.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia Podpisane /char podpisane Niepodpisane /char bez znaku Ascii /char ascii7 Aby uzyskać więcej informacji, zobacz /char opcja w dokumentacji wiersza polecenia MIDL.
DllDataFileName
Opcjonalny parametr ciągu .
Określa nazwę pliku wygenerowanego pliku dlldata dla proxy DLL.
Aby uzyskać więcej informacji, zobacz opcję /dlldata w dokumentacji wiersza polecenia MIDL.
EnableErrorChecks
Opcjonalny parametr ciągu .
Określa typ sprawdzania błędów, czy wygenerowane wycinki będą wykonywane w czasie wykonywania.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia Brak /error none WłączDostosuj /Błąd Wszystkich /error all Aby uzyskać więcej informacji, zobacz /error opcja w dokumentacji wiersza polecenia MIDL.
ErrorCheckAllocations
Opcjonalny parametr logiczny .
Jeśli
true, sprawdź błędy braku pamięci.Aby uzyskać więcej informacji, zobacz opcję /error allocation w dokumentacji wiersza polecenia MIDL.
ErrorCheckBounds
Opcjonalny parametr logiczny .
Jeśli
trueprogram sprawdza rozmiar zgodnej i różnej tablicy w odniesieniu do specyfikacji długości transmisji.Aby uzyskać więcej informacji, zobacz /error bounds_check opcja w dokumentacji wiersza polecenia MIDL.
ErrorCheckEnumRange
Opcjonalny parametr logiczny .
Jeśli
trueprogram sprawdza, czy wartości wyliczenia znajdują się w dozwolonym zakresie.Aby uzyskać więcej informacji, zobacz /error enum option in command-line help (/?) for midl.exe (/?) opcja /error enum w pomocy wiersza polecenia (/?) dla midl.exe.
ErrorCheckRefPointers
Opcjonalny parametr logiczny .
Jeśli
trueprogram , sprawdź, czy żadne wskaźniki odniesienia o wartości null nie są przekazywane do wycinków klienta.Aby uzyskać więcej informacji, zobacz /error ref opcji w dokumentacji wiersza polecenia MIDL.
ErrorCheckStubData
Opcjonalny parametr logiczny .
Jeśli
trueprogram generuje wycinkę, która przechwytuje wyjątki bez wyręczania po stronie serwera i propaguje je z powrotem do klienta.Aby uzyskać więcej informacji, zobacz /error stub_data opcja w dokumentacji wiersza polecenia MIDL.
GenerateClientFiles
Opcjonalny parametr ciągu .
Określa, czy kompilator generuje pliki źródłowe języka C po stronie klienta dla interfejsu RPC.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia Brak /client none Skrótowej /client stub Aby uzyskać więcej informacji, zobacz /client option in MIDL command-line reference (Opcja /client w dokumentacji wiersza polecenia MIDL).
GenerateServerFiles
Opcjonalny parametr ciągu .
Określa, czy kompilator generuje pliki źródłowe C po stronie serwera dla interfejsu RPC.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia Brak /server none Skrótowej /server stub Aby uzyskać więcej informacji, zobacz /server option in MIDL command-line reference (Opcja /server w dokumentacji wiersza polecenia MIDL).
GenerateStublessProxies
Opcjonalny parametr logiczny .
Jeśli
trueelement generuje w pełni interpretowane wycinki wraz z serwerami proxy bezskuteczne dla interfejsów obiektów.Aby uzyskać więcej informacji, zobacz opcję /Oicf w dokumentacji wiersza polecenia MIDL.
GenerateTypeLibrary
Opcjonalny parametr logiczny .
Jeśli
trueplik biblioteki typów (.tlb) nie jest generowany.Aby uzyskać więcej informacji, zobacz /notlb opcji w dokumentacji wiersza polecenia MIDL.
Nazwa pliku nagłówka
Opcjonalny parametr ciągu .
Określa nazwę wygenerowanego pliku nagłówka.
Aby uzyskać więcej informacji, zobacz /h lub /header opcji w dokumentacji wiersza polecenia MIDL.
IgnoreStandardIncludePath
Opcjonalny parametr logiczny .
Jeśli
truezadanie MIDL wyszukuje tylko katalogi określone przy użyciu przełącznika AdditionalIncludeDirectories i ignoruje bieżący katalog i katalogi określone przez zmienną środowiskową INCLUDE.Aby uzyskać więcej informacji, zobacz /no_def_idir opcja w dokumentacji wiersza polecenia MIDL.
InterfaceIdentifierFileName
Opcjonalny parametr ciągu .
Określa nazwę pliku identyfikatora interfejsu dla interfejsu COM. Spowoduje to zastąpienie domyślnej nazwy uzyskanej przez dodanie ciągu "_i.c" do nazwy pliku IDL.
Aby uzyskać więcej informacji, zobacz /iid opcji w dokumentacji wiersza polecenia MIDL.
Localeid
Opcjonalny parametr int .
Określa identyfikator ustawień regionalnych, który umożliwia używanie znaków międzynarodowych w plikach wejściowych, nazwach plików i ścieżkach katalogu. Określ identyfikator ustawień regionalnych dziesiętnych.
Aby uzyskać więcej informacji, zobacz /lcid opcji w dokumentacji wiersza polecenia MIDL. Zobacz również identyfikatory ustawień regionalnych.
MkTypLibCompatible
Opcjonalny parametr logiczny .
Jeśli
trueparametr wymaga formatu pliku wejściowego, aby był zgodny z plikiem mktyplib.exe w wersji 2.03.Aby uzyskać więcej informacji, zobacz opcję /mktyplib203 w dokumentacji wiersza polecenia MIDL. Zobacz również składnię pliku ODL w witrynie sieci Web MSDN.
OutputDirectory
Opcjonalny parametr ciągu .
Określa katalog domyślny, w którym zadanie MIDL zapisuje pliki wyjściowe.
Aby uzyskać więcej informacji, zobacz /out opcji w dokumentacji wiersza polecenia MIDL.
PreprocesorDefinitions
Opcjonalny parametr String[] .
Określa co najmniej jedną definicję, czyli nazwę i opcjonalną wartość, która ma zostać przekazana do preprocesora języka C, tak jak w przypadku
#definedyrektywy. Formą każdej definicji jest nazwa[=wartość].Aby uzyskać więcej informacji, zobacz /D opcja w dokumentacji wiersza polecenia MIDL. Zobacz również parametr UndefinePreprocessorDefinitions w tej tabeli.
Nazwapliku serwera proxy
Opcjonalny parametr ciągu .
Określa nazwę pliku serwera proxy interfejsu dla interfejsu COM.
Aby uzyskać więcej informacji, zobacz /proxy opcji w dokumentacji wiersza polecenia MIDL.
RedirectOutputAndErrors
Opcjonalny parametr ciągu .
Przekierowuje dane wyjściowe, takie jak komunikaty o błędach i ostrzeżenia, ze standardowych danych wyjściowych do określonego pliku.
Aby uzyskać więcej informacji, zobacz /o opcja w dokumentacji wiersza polecenia MIDL.
ServerStubFile
Opcjonalny parametr ciągu .
Określa nazwę pliku wycinkowego serwera dla interfejsu RPC.
Aby uzyskać więcej informacji, zobacz /sstub opcja w dokumentacji wiersza polecenia MIDL. Zobacz również parametr ClientStubFile w tej tabeli.
Source
Wymagany parametr interfejsu
ITaskItem[].Określa listę plików źródłowych rozdzielonych spacjami.
StructMemberAlignment
Opcjonalny parametr ciągu .
Określa wyrównanie (poziom pakowania) struktur w systemie docelowym.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia Notset <none> 1 /Zp1 2 /Zp2 4 /Zp4 8 /Zp8 Aby uzyskać więcej informacji, zobacz /Zp opcji w dokumentacji wiersza polecenia MIDL. / Zp opcja jest odpowiednikiem /pack opcji i starsze /align opcji.
SuppressCompilerWarnings
Opcjonalny parametr logiczny .
Jeśli
trueprogram pomija komunikaty ostrzegawcze z zadania MIDL.Aby uzyskać więcej informacji, zobacz /no_warn opcja w dokumentacji wiersza polecenia MIDL.
SuppressStartupBanner
Opcjonalny
Booleanparametr.Jeśli
trueprogram uniemożliwia wyświetlanie komunikatu o prawach autorskich i numerze wersji podczas uruchamiania zadania.Aby uzyskać więcej informacji, zobacz opcję /nologo w dokumentacji wiersza polecenia MIDL.
TargetEnvironment
Opcjonalny parametr ciągu .
Określa środowisko, w którym działa aplikacja.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia Notset <none> Win32 /env win32 Itanium /env ia64 X64 /env x64 Aby uzyskać więcej informacji, zobacz /env opcji w dokumentacji wiersza polecenia MIDL.
TrackerLogDirectory
Opcjonalny
Stringparametr.Określa katalog pośredni, w którym są przechowywane dzienniki śledzenia dla tego zadania.
TypeLibFormat
Opcjonalny parametr ciągu .
Określa format pliku biblioteki typów.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia Nowyformat /newtlb Staryformat /oldtlb Aby uzyskać więcej informacji, zobacz opcje /newtlb i /oldtlb w dokumentacji wiersza polecenia MIDL.
TypeLibraryName
Opcjonalny parametr ciągu .
Określa nazwę pliku biblioteki typów.
Aby uzyskać więcej informacji, zobacz /tlb opcji w dokumentacji wiersza polecenia MIDL.
UndefinePreprocessorDefinitions
Opcjonalny parametr String[] .
Usuwa dowolną poprzednią definicję nazwy, przekazując nazwę do preprocesora języka C, tak jak w przypadku
#undefinedyrektywy. Określ co najmniej jedną zdefiniowaną wcześniej nazwę.Aby uzyskać więcej informacji, zobacz /U opcja w dokumentacji wiersza polecenia MIDL. Zobacz również parametr PreprocessorDefinitions w tej tabeli.
ValidateAllParameters
Opcjonalny
Booleanparametr.Jeśli
trueprogram generuje dodatkowe informacje sprawdzające błędy, które są używane do przeprowadzania kontroli integralności w czasie wykonywania. Jeślifalsewartość , informacje dotyczące sprawdzania błędów nie są generowane.Aby uzyskać więcej informacji, zobacz /robust i /no_robust opcje w dokumentacji wiersza polecenia MIDL.
WarnAsError
Opcjonalny
Booleanparametr.Jeśli
trueparametr traktuje wszystkie ostrzeżenia jako błędy.Jeśli parametr zadania WarningLevel MIDL nie jest określony, ostrzeżenia na poziomie domyślnym, poziom 1, są traktowane jako błędy.
Aby uzyskać więcej informacji, zobacz /WX options in MIDL command-line reference (Opcje /WX w dokumentacji wiersza polecenia MIDL). Zobacz również parametr WarningLevel w tej tabeli.
Warninglevel
Opcjonalny parametr ciągu .
Określa ważność (poziom ostrzeżenia) ostrzeżeń do emisji. Żadne ostrzeżenie nie jest emitowane dla wartości 0. W przeciwnym razie ostrzeżenie jest emitowane, jeśli jego poziom ostrzeżenia jest liczbowo mniejszy lub równy określonej wartości.
Określ jedną z następujących wartości, z których każda odpowiada opcji wiersza polecenia.
Wartość Opcja wiersza polecenia 0 /W0 1 /W1 2 /W2 3 /W3 4 /W4 Aby uzyskać więcej informacji, zobacz /W opcja w dokumentacji wiersza polecenia MIDL. Zobacz również parametr WarnAsError w tej tabeli.