Bagikan melalui

Menggunakan MIDL

  • Artikel

Semua antarmuka untuk program yang menggunakan RPC harus didefinisikan dalam Microsoft Interface Definition Language (MIDL) dan dikompilasi dengan pengkompilasi MIDL. Topik berikut menyajikan gambaran singkat tentang membuat dan mengkompilasi antarmuka MIDL:

Untuk diskusi terperinci tentang topik-topik ini, lihat File IDL dan ACF.

Menentukan Antarmuka dengan MIDL

File MIDL adalah file teks yang dapat Anda buat dan edit dengan editor teks. Jika Anda membuat UUID untuk antarmuka Anda, Anda biasanya akan menyimpan output dalam file MIDL templat. Untuk informasi selengkapnya tentang UUID, lihat Menghasilkan UUID Antarmuka.

Semua antarmuka di MIDL mengikuti format yang sama. Mereka dimulai dengan header yang berisi daftar atribut antarmuka dan nama antarmuka. Atribut diapit dalam tanda kurung siku. Header antarmuka diikuti oleh isinya, yang diapit dalam tanda kurung kurawal. Antarmuka sederhana ditampilkan dalam contoh berikut:

[
  uuid(ba209999-0c6c-11d2-97cf-00c04f8eea45),
  version(1.0)
]
interface MyInterface
{
  const unsigned short INT_ARRAY_LEN = 100;

  void MyRemoteProc( 
      [in] int param1,
      [out] int outArray[INT_ARRAY_LEN]
  );
}

Beberapa atribut yang biasanya muncul dalam definisi antarmuka MIDL adalah UUID dan nomor versi antarmuka. Isi definisi antarmuka harus berisi deklarasi prosedur semua prosedur jarak jauh di antarmuka. Ini juga dapat berisi deklarasi jenis data dan konstanta yang diperlukan oleh antarmuka.

Semua parameter dalam deklarasi prosedur jarak jauh harus dinyatakan sebagai [in], [out], atau [in, out]. Deklarasi ini menentukan bahwa program klien meneruskan data ke prosedur jarak jauh, mengeluarkan data dari prosedur jarak jauh, atau keduanya. Untuk informasi selengkapnya tentang deklarasi parameter antarmuka, lihat Isi Antarmuka IDL.

Mengkompilasi File MIDL

Pengkompilasi MIDL adalah alat baris perintah yang secara otomatis diinstal dengan Kit Pengembangan Perangkat Lunak Platform (SDK). Panggil di jendela perintah dengan mengetik perintah midl, diikuti dengan nama file MIDL, di baris perintah. Pastikan bahwa direktori yang berisi pengkompilasi MIDL ada di jalur Anda. Contoh berikut mengilustrasikan penggunaannya:

midl MyApp.idl

Perhatikan bahwa Anda tidak perlu menyertakan ekstensi jika nama file memiliki ekstensi .idl. Anda juga dapat menggunakan sakelar baris perintah pengkompilasi MIDL dengan menyisipkannya antara perintah midl dan nama file. Ini ditunjukkan dalam contoh berikut:

midl /acf MyApp.acf MyApp.idl

Dalam contoh ini, pengkompilasi MIDL dijalankan menggunakan file MyApp.idl sebagai file input. Sakelar baris perintah /acf menginstruksikan pengkompilasi untuk menggunakan file konfigurasi aplikasi (ACF) untuk input juga. File konfigurasi aplikasi dibahas lebih menyeluruh dalam File IDL dan ACF.

Untuk informasi lebih rinci tentang menggunakan pengkompilasi MIDL, lihat Microsoft Interface Definition Language (MIDL), yang berisi informasi tentang topik berikut: