MIDL – úloha

  • Článek

Zabalí nástroj kompilátoru MIDL (Microsoft Interface Definition Language), midl.exe. Další informace najdete v tématu MIDL – referenční informace k příkazovému řádku.

Parametry

Následující část popisuje parametry úlohy MIDL . Většina parametrů úkolu a několik sad parametrů odpovídá možnosti příkazového řádku.

  • AdditionalIncludeDirectories

    Volitelný parametr String[]

    Přidá adresář do seznamu adresářů, které se hledají pro importované soubory IDL, zahrnuté hlavičkové soubory a konfigurační soubory aplikace (ACF).

    Další informace najdete v části /I v referenčních informacích k příkazovému řádku MIDL.

  • AdditionalOptions

    Volitelný parametr String .

    Seznam možností příkazového řádku Například /<option1> /<option2> /<option#>. Tento parametr použijte k určení možností příkazového řádku, které nejsou reprezentovány žádným jiným parametrem úlohy MIDL.

    Další informace najdete v tématu MIDL – referenční informace k příkazovému řádku.

  • ApplicationConfigurationMode

    Volitelný logický parametr.

    Pokud true, umožňuje použít některá klíčová slova ACF v souboru IDL.

    Další informace najdete v odkazu na příkazový řádek MIDL v části /app_config.

  • ClientStubFile

    Volitelný parametr String .

    Určuje název souboru procedur klienta pro rozhraní RPC.

    Další informace najdete v odkazu na příkazový řádek MIDL v možnosti /cstub. Viz také parametr ServerStubFile v této tabulce.

  • CPreprocessOptions

    Volitelný parametr String .

    Určuje možnosti předání preprocesoru C/C++. Zadejte seznam možností preprocesoru oddělených mezerami. Musí obsahovat /E možnost.

    Další informace najdete v tématu /cpp_opt v referenčních informacích k příkazovému řádku MIDL.

  • DefaultCharType

    Volitelný parametr String .

    Určuje výchozí typ znaku, který kompilátor jazyka C použije ke kompilaci generovaného kódu.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    Podepsané /char signed
    Nepodepsané /char bez znaménka
    Ascii /char ascii7

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /char.

  • DllDataFileName

    Volitelný parametr String .

    Určuje název souboru pro vygenerovaný soubor dlldata pro knihovnu DLL proxy.

    Další informace naleznete v souboru /dlldata v odkazu na příkazový řádek MIDL.

  • EnableErrorChecks

    Volitelný parametr String .

    Určuje typ kontroly chyb, kterou budou generované zástupné procedury provádět za běhu.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    Nezaokrouhlovat /error none
    EnableCustom /Chyba
    Všechny /error all

    Další informace najdete v odkazu na příkazový řádek MIDL s možností /error.

  • ErrorCheckAllocations

    Volitelný logický parametr.

    Pokud true, zkontrolujte chyby nedostatku paměti.

    Další informace naleznete v tématu /error allocation option in MIDL command-line reference.

  • ErrorCheckBounds

    Volitelný logický parametr.

    Pokud true, zkontroluje velikost shodných a proměnlivých polí podle specifikace délky přenosu.

    Další informace najdete v tématu /error bounds_check možnost v odkazu na příkazový řádek MIDL.

  • ErrorCheckEnumRange

    Volitelný logický parametr.

    Pokud true, zkontroluje, zda jsou hodnoty výčtu v povoleném rozsahu.

    Další informace naleznete v parametru /error enum v nápovědě příkazového řádku (/?) pro midl.exe.

  • ErrorCheckRefPointers

    Volitelný logický parametr.

    Pokud true, zkontrolujte, že klientům nejsou předány žádné referenční ukazatele null.

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /error ref.

  • ErrorCheckStubData

    Volitelný logický parametr.

    Pokud truevygeneruje zástupný kód, který zachytí výjimky, které na straně serveru nezachytí, a rozšíří je zpět do klienta.

    Další informace najdete v tématu /error stub_data možnost v referenčních informacích k příkazovému řádku MIDL.

  • GenerateClientFiles

    Volitelný parametr String .

    Určuje, zda kompilátor generuje zdrojové soubory C na straně klienta pro rozhraní RPC.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    Nezaokrouhlovat /client none
    Se zakázaným inzerováním Zástupný kód /client

    Další informace najdete v odkazu na příkazový řádek MIDL v možnosti /client.

  • GenerateServerFiles

    Volitelný parametr String .

    Určuje, zda kompilátor generuje zdrojové soubory C na straně serveru pro rozhraní RPC.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    Nezaokrouhlovat /server none
    Se zakázaným inzerováním Zástupný název serveru /server

    Další informace najdete v tématu /server v referenčních informacích k příkazovému řádku MIDL.

  • Generováníproxůtubless

    Volitelný logický parametr.

    Pokud truevygeneruje plně interpretované zástupné procedury společně s zástupnými proxy servery pro rozhraní objektů.

    Další informace najdete v odkazu na příkazový řádek MIDL s možností /Oicf.

  • GenerateTypeLibrary

    Volitelný logický parametr.

    Pokud truesoubor knihovny typů (.tlb) není generován.

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /notlb.

  • HeaderFileName

    Volitelný parametr String .

    Určuje název vygenerovaného souboru hlaviček.

    Další informace najdete v odkazu na příkazový řádek MIDL v parametru /h nebo /header.

  • IgnoreStandardIncludePath

    Volitelný logický parametr.

    Pokud trueúloha MIDL prohledá pouze adresáře zadané pomocí přepínače AdditionalIncludeDirectories a ignoruje aktuální adresář a adresáře určené proměnnou prostředí INCLUDE.

    Další informace najdete v odkazu na příkazový řádek MIDL v části /no_def_idir.

  • InterfaceIdentifierFileName

    Volitelný parametr String .

    Určuje název souboru identifikátoru rozhraní pro rozhraní MODELU COM. Tím se přepíše výchozí název získaný přidáním "_i.c" do názvu souboru IDL.

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /iid.

  • Localeid

    Volitelný parametr int .

    Určuje identifikátor národního prostředí, který umožňuje používat mezinárodní znaky ve vstupních souborech, názvech souborů a cestách k adresářům. Zadejte identifikátor desítkového národního prostředí.

    Další informace najdete v odkazu na příkazový řádek MIDL v parametru /lcid. Viz také identifikátory národního prostředí.

  • MkTypLibCompatible

    Volitelný logický parametr.

    Pokud true, vyžaduje formát vstupního souboru, aby byl kompatibilní s mktyplib.exe verze 2.03.

    Další informace najdete v odkazu na příkazový řádek MIDL v části /mktyplib203. Viz také syntaxe souboru ODL na webu MSDN.

  • OutputDirectory

    Volitelný parametr String .

    Určuje výchozí adresář, do kterého úloha MIDL zapisuje výstupní soubory.

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /out.

  • PreprocessorDefinitions

    Volitelný parametr String[]

    Určuje jednu nebo více definic. To znamená název a volitelnou hodnotu, která se má předat preprocesoru jazyka C, jako by to byla direktiva #define . Forma každé definice je name[=value].

    Další informace najdete v odkazu na příkazový řádek MIDL v parametru /D. Podívejte se také na parametr UndefinePreprocessorDefinitions v této tabulce.

  • ProxyFileName

    Volitelný parametr String .

    Určuje název souboru proxy rozhraní pro rozhraní COM.

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /proxy.

  • RedirectOutputAndErrors

    Volitelný parametr String .

    Přesměruje výstup, jako jsou chybové zprávy a upozornění, ze standardního výstupu do zadaného souboru.

    Další informace najdete v odkazu na příkazový řádek MIDL v parametru /o.

  • ServerStubFile

    Volitelný parametr String .

    Určuje název souboru zástupných procedur serveru pro rozhraní RPC.

    Další informace najdete v odkazu na příkazový řádek MIDL v části /sstub. Viz také parametr ClientStubFile v této tabulce.

  • Source

    Požadovaný parametr ITaskItem[].

    Určuje seznam zdrojových souborů oddělených mezerami.

  • StructMemberAlignment

    Volitelný parametr String .

    Určuje zarovnání (úroveň balení) struktur v cílovém systému.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    Notset <žádné>
    1 /Zp1
    2 /Zp2
    4 /Zp4
    8 /Zp8

    Další informace najdete v odkazu na příkazový řádek MIDL v možnosti /Zp. Možnost /Zp odpovídá možnosti /pack a starší možnosti /align .

  • SuppressCompilerWarnings

    Volitelný logický parametr.

    Pokud truepotlačí upozornění zprávy z úlohy MIDL.

    Další informace najdete v odkazu na příkazový řádek MIDL v části /no_warn.

  • SuppressStartupBanner

    Volitelný Boolean parametr.

    Pokud truepři spuštění úkolu zabrání zobrazení zprávy o autorských právech a čísle verze.

    Další informace najdete v odkazu na příkazový řádek MIDL v parametru /nologo.

  • TargetEnvironment

    Volitelný parametr String .

    Určuje prostředí, ve kterém se aplikace spouští.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    Notset <žádné>
    Win32 /env win32
    Itanium /env ia64
    X64 /env x64

    Další informace najdete v odkazu na příkazový řádek MIDL v možnosti /env.

  • TrackerLogDirectory

    Volitelný String parametr.

    Určuje zprostředkující adresář, ve kterém jsou uloženy protokoly sledování pro tuto úlohu.

  • TypeLibFormat

    Volitelný parametr String .

    Určuje formát souboru knihovny typů.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    NewFormat /newtlb
    Starý formát /oldtlb

    Další informace najdete v tématu o možnostech /newtlb a /oldtlb v referenčních informacích k příkazovému řádku MIDL.

  • TypeLibraryName

    Volitelný parametr String .

    Určuje název souboru knihovny typů.

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /tlb.

  • UndefinePreprocessorDefinitions

    Volitelný parametr String[]

    Odebere všechny předchozí definice názvu předáním názvu do preprocesoru jazyka C, jako by direktiva #undefine . Zadejte jeden nebo více dříve definovaných názvů.

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /U. Viz také parametr PreprocessorDefinitions v této tabulce.

  • ValidateAllParameters

    Volitelný Boolean parametr.

    Pokud truevygeneruje další informace kontroly chyb, které slouží k provádění kontrol integrity za běhu. Pokud falsese informace kontroly chyb negenerují.

    Další informace najdete v referenčních informacích k příkazovému řádku MIDL v možnostech /robust a /no_robust.

  • WarnAsError

    Volitelný Boolean parametr.

    Pokud truese zachází se všemi upozorněními jako s chybami.

    Pokud není zadaný parametr úlohy WarningLevel MIDL, budou se upozornění na výchozí úrovni úrovně 1 považovat za chyby.

    Další informace najdete v tématu o možnostech /WX v referenčních informacích k příkazovému řádku MIDL. V této tabulce se také podívejte na parametr WarningLevel .

  • WarningLevel

    Volitelný parametr String .

    Určuje závažnost (úroveň upozornění) upozornění, která se mají generovat. Pro hodnotu 0 se nevygeneruje žádné upozornění. V opačném případě se upozornění vygeneruje, pokud je její úroveň upozornění číselně menší nebo rovna zadané hodnotě.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    Hodnota Možnost příkazového řádku
    0 /W0
    1 /W1
    2 /W2
    3 /W3
    4 /W4

    Další informace najdete v odkazu na příkazový řádek MIDL na možnost /W. Viz také parametr WarnAsError v této tabulce.

Viz také