Share via

Tugas MIDL

  • Artikel

Membungkus alat kompilator Microsoft Interface Definition Language (MIDL), midl.exe. Untuk informasi selengkapnya, lihat referensi baris perintah MIDL.

Parameter

Berikut ini menjelaskan parameter tugas MIDL. Sebagian besar parameter tugas, dan beberapa set parameter, sesuai dengan opsi baris perintah.

  • AdditionalIncludeDirectories

    Parameter String[] opsional.

    Menambahkan direktori ke daftar direktori yang mencari file IDL yang diimpor, termasuk file header, dan file konfigurasi aplikasi (ACF).

    Untuk informasi selengkapnya, lihat opsi /I di referensi baris perintah MIDL.

  • AdditionalOptions

    Parameter String opsional.

    Daftar opsi baris perintah. Misalnya, /<option1> /<option2> /<option#>. Gunakan parameter ini untuk menentukan opsi baris perintah yang tidak diwakili oleh parameter tugas MIDL lainnya.

    Untuk informasi selengkapnya, lihat referensi baris perintah MIDL.

  • ApplicationConfigurationMode

    Parameter Boolean opsional.

    Jika true, memungkinkan Anda menggunakan beberapa kata kunci ACF dalam file IDL.

    Untuk informasi selengkapnya, lihat opsi /app_config di referensi baris perintah MIDL.

  • ClientStubFile

    Parameter String opsional.

    Menentukan nama file stub klien untuk antarmuka RPC.

    Untuk informasi selengkapnya, lihat opsi /cstub di referensi baris perintah MIDL. Lihat juga parameter ServerStubFile dalam tabel ini.

  • CPreprocessOptions

    Parameter String opsional.

    Menentukan opsi untuk diteruskan ke praprosesor C/C++. Tentukan daftar opsi praprosesor yang dibatasi spasi. Harus berisi opsi /E.

    Untuk informasi selengkapnya, lihat opsi /cpp_opt di referensi baris perintah MIDL.

  • DefaultCharType

    Parameter String opsional.

    Menentukan jenis karakter default yang akan digunakan kompilator C untuk mengompilasi kode yang dihasilkan.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    Ditandatangani /char signed
    Unsigned /char unsigned
    Ascii /char ascii7

    Untuk informasi selengkapnya, lihat opsi /char di referensi baris perintah MIDL.

  • DllDataFileName

    Parameter String opsional.

    Menentukan nama file untuk file dlldata yang dihasilkan untuk DLL proksi.

    Untuk informasi selengkapnya, lihat opsi /dlldata di referensi baris perintah MIDL.

  • EnableErrorChecks

    Parameter String opsional.

    Menentukan jenis pemeriksaan kesalahan yang akan dilakukan oleh stub yang dihasilkan pada durasi.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    Tidak ada /error none
    EnableCustom /error
    Semua /error all

    Untuk informasi selengkapnya, lihat opsi /error di referensi baris perintah MIDL.

  • ErrorCheckAllocations

    Parameter Boolean opsional.

    Jika true, memeriksa kesalahan kehabisan memori.

    Untuk informasi selengkapnya, lihat opsi /error allocation di referensi baris perintah MIDL.

  • ErrorCheckBounds

    Parameter Boolean opsional.

    Jika true, memeriksa ukuran array yang bervariasi dan bervariasi sesuai dengan spesifikasi panjang transmisi.

    Untuk informasi selengkapnya, lihat opsi /error bounds_check di referensi baris perintah MIDL.

  • ErrorCheckEnumRange

    Parameter Boolean opsional.

    Jika true, memeriksa apakah nilai enum berada dalam rentang yang diizinkan.

    Untuk informasi selengkapnya, lihat opsi /error enum di bantuan baris perintah (/?) untuk midl.exe.

  • ErrorCheckRefPointers

    Parameter Boolean opsional.

    Jika true, memeriksa apakah tidak ada pointer referensi null yang diteruskan ke stub klien.

    Untuk informasi selengkapnya, lihat opsi /error ref di referensi baris perintah MIDL.

  • ErrorCheckStubData

    Parameter Boolean opsional.

    Jika true, menghasilkan stub yang menangkap pengecualian yang tidak disusun di sisi server dan menyebarkannya kembali ke klien.

    Untuk informasi selengkapnya, lihat opsi /error stub_data di referensi baris perintah MIDL.

  • GenerateClientFiles

    Parameter String opsional.

    Menentukan apakah kompilator menghasilkan file sumber C sisi klien untuk antarmuka RPC.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    Tidak ada /client none
    Stub /client stub

    Untuk informasi selengkapnya, lihat opsi /client di referensi baris perintah MIDL.

  • GenerateServerFiles

    Parameter String opsional.

    Menentukan apakah kompilator menghasilkan file sumber C sisi server untuk antarmuka RPC.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    Tidak ada /server none
    Stub /server stub

    Untuk informasi selengkapnya, lihat opsi /server di referensi baris perintah MIDL.

  • GenerateStublessProxies

    Parameter Boolean opsional.

    Jika true, menghasilkan stub yang ditafsirkan sepenuhnya bersama-sama dengan proksi stubless untuk antarmuka objek.

    Untuk informasi selengkapnya, lihat opsi /Oicf di referensi baris perintah MIDL.

  • GenerateTypeLibrary

    Parameter Boolean opsional.

    Jika true, file pustaka jenis (.tlb) tidak dihasilkan.

    Untuk informasi selengkapnya, lihat opsi /notlb di referensi baris perintah MIDL.

  • HeaderFileName

    Parameter String opsional.

    Menentukan nama file header yang dihasilkan.

    Untuk informasi selengkapnya, lihat opsi /h atau /header di referensi baris perintah MIDL.

  • IgnoreStandardIncludePath

    Parameter Boolean opsional.

    Jika true, tugas MIDL hanya mencari direktori yang ditentukan menggunakan switch AdditionalIncludeDirectories, dan mengabaikan direktori saat ini dan direktori yang ditentukan oleh variabel lingkungan INCLUDE.

    Untuk informasi selengkapnya, lihat opsi /no_def_idir di referensi baris perintah MIDL.

  • InterfaceIdentifierFileName

    Parameter String opsional.

    Menentukan nama file pengidentifikasi antarmuka untuk antarmuka COM. Ini mengambil alih nama default yang diperoleh dengan menambahkan "_i.c" ke nama file IDL.

    Untuk informasi selengkapnya, lihat opsi /iid di referensi baris perintah MIDL.

  • LocaleID

    Parameter int opsional.

    Menentukan pengidentifikasi lokal yang memungkinkan penggunaan karakter internasional dalam file input, nama file, dan jalur direktori. Tentukan pengidentifikasi lokal desimal.

    Untuk informasi selengkapnya, lihat opsi /lcid di referensi baris perintah MIDL. Lihat juga Pengidentifikasi lokal.

  • MkTypLibCompatible

    Parameter Boolean opsional.

    Jika true, format file input harus kompatibel dengan mktyplib.exe versi 2.03.

    Untuk informasi selengkapnya, lihat opsi /mktyplib203 di referensi baris perintah MIDL. Lihat juga sintaksis file ODL di situs web MSDN.

  • OutputDirectory

    Parameter String opsional.

    Menentukan direktori default tempat tugas MIDL menulis file output.

    Untuk informasi selengkapnya, lihat opsi /out di referensi baris perintah MIDL.

  • PreprocessorDefinitions

    Parameter String[] opsional.

    Menentukan satu atau beberapa definisi; yaitu, nama dan nilai opsional yang akan diteruskan ke praprosesor C seolah-olah oleh arahan #define. Bentuk setiap definisi adalah, name[=value].

    Untuk informasi selengkapnya, lihat opsi /D di referensi baris perintah MIDL. Lihat juga parameter UndefinePreprocessorDefinitions dalam tabel ini.

  • ProxyFileName

    Parameter String opsional.

    Menentukan nama file proksi antarmuka untuk antarmuka COM.

    Untuk informasi selengkapnya, lihat opsi /proxy di referensi baris perintah MIDL.

  • RedirectOutputAndErrors

    Parameter String opsional.

    Mengalihkan output, seperti pesan kesalahan dan peringatan, dari output standar ke file yang ditentukan.

    Untuk informasi selengkapnya, lihat opsi /o di referensi baris perintah MIDL.

  • ServerStubFile

    Parameter String opsional.

    Menentukan nama file stub server untuk antarmuka RPC.

    Untuk informasi selengkapnya, lihat opsi /sstub di referensi baris perintah MIDL. Lihat juga parameter ClientStubFile dalam tabel ini.

  • Sumber

    Parameter ITaskItem[] wajib.

    Tentukan daftar file sumber yang dipisahkan oleh spasi.

  • StructMemberAlignment

    Parameter String opsional.

    Menentukan perataan (tingkat pengemasan) struktur dalam sistem target.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    NotSet <Tidak ada>
    1 /Zp1
    2 /Zp2
    4 /Zp4
    8 /Zp8

    Untuk informasi selengkapnya, lihat opsi /Zp di referensi baris perintah MIDL. Opsi /Zp setara dengan opsi /pack dan opsi /align yang lebih lama.

  • SuppressCompilerWarnings

    Parameter Boolean opsional.

    Jika true, menekan pesan peringatan dari tugas MIDL.

    Untuk informasi selengkapnya, lihat opsi /no_warn di referensi baris perintah MIDL.

  • SuppressStartupBanner

    Parameter Boolean opsional.

    Jika true, mencegah tampilan pesan hak cipta dan nomor versi saat tugas dimulai.

    Untuk informasi selengkapnya, lihat opsi /nologo di referensi baris perintah MIDL.

  • TargetEnvironment

    Parameter String opsional.

    Menentukan lingkungan tempat aplikasi berjalan.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    NotSet <Tidak ada>
    Win32 /env win32
    Itanium /env ia64
    X64 /env x64

    Untuk informasi selengkapnya, lihat opsi /env di referensi baris perintah MIDL.

  • TrackerLogDirectory

    Parameter String opsional.

    Tentukan direktori perantara tempat log pelacakan untuk tugas ini disimpan.

  • TypeLibFormat

    Parameter String opsional.

    Menentukan format file pustaka jenis.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    NewFormat /newtlb
    OldFormat /oldtlb

    Untuk informasi selengkapnya, lihat opsi /newtlb dan /oldtlb di referensi baris perintah MIDL.

  • TypeLibraryName

    Parameter String opsional.

    Menentukan nama file pustaka jenis.

    Untuk informasi selengkapnya, lihat opsi /tlb di referensi baris perintah MIDL.

  • UndefinePreprocessorDefinitions

    Parameter String[] opsional.

    Menghapus definisi nama sebelumnya dengan meneruskan nama tersebut ke praprosesor C seolah-olah dengan arahan #undefine. Tentukan satu atau beberapa nama yang ditentukan sebelumnya.

    Untuk informasi selengkapnya, lihat opsi /U di referensi baris perintah MIDL. Lihat juga parameter PreprocessorDefinitions dalam tabel ini.

  • ValidateAllParameters

    Parameter Boolean opsional.

    Jika true, menghasilkan informasi pemeriksaan kesalahan tambahan yang digunakan untuk melakukan pemeriksaan integritas pada durasi. Jika false, informasi pemeriksaan kesalahan tidak dibuat.

    Untuk informasi selengkapnya, lihat opsi /robust dan /no_robust dalam referensi baris perintah MIDL.

  • WarnAsError

    Parameter Boolean opsional.

    Jika true, memperlakukan semua peringatan sebagai kesalahan.

    Jika parameter tugas MIDL WarningLevel tidak ditentukan, peringatan pada tingkat default, tingkat 1, akan dianggap sebagai kesalahan.

    Untuk informasi selengkapnya, lihat opsi /WX di referensi baris perintah MIDL. Lihat juga parameter WarningLevel dalam tabel ini.

  • WarningLevel

    Parameter String opsional.

    Menentukan tingkat keparahan (tingkat peringatan) peringatan yang akan dikeluarkan. Tidak ada peringatan yang dikeluarkan untuk nilai 0. Jika tidak, peringatan dikeluarkan jika tingkat peringatannya secara numerik kurang dari atau sama dengan nilai yang ditentukan.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    Nilai Opsi baris perintah
    0 /W0
    1 /W1
    2 /W2
    3 /W3
    4 /W4

    Untuk informasi selengkapnya, lihat opsi /W di referensi baris perintah MIDL. Lihat juga parameter WarnAsError dalam tabel ini.

Baca juga