File Proksi Antarmuka

File proksi antarmuka (U_p.c) adalah file C yang berisi rutinitas yang setara dengan yang ada di stub klien dan file stub server antarmuka objek (COM). file ini berisi implementasi rutin pengganti untuk klien dan server dalam mode sebaris dari pengkompilasi atau data dan thunks yang setara dalam mode yang ditafsirkan, serta data lem COM lainnya yang sesuai, seperti proksi dan stub VTables.

File proksi antarmuka mencakup rutinitas dan data pendukung hanya untuk metode antarmuka yang ditentukan dalam file IDL saat ini. Untuk mengklarifikasi perilaku ini, contoh yang diperluas digunakan di seluruh bagian ini. Saat mengkompilasi file IDL dengan antarmuka seperti IFaceB yang mewarisi dari IFaceA, data dan rutinitas tambahan terkait IFaceB dihasilkan ke file proksi saat ini, sementara antarmuka dasar IFaceA terkait data tambahan dan rutinitas ditemukan dalam proksi yang dihasilkan dari file IDL yang berisi definisi IFaceA. Kompilator menghasilkan semua data yang diperlukan untuk mengidentifikasi pengganti antarmuka dasar, dan untuk mendelegasikan kepada mereka ketika diperlukan untuk mendukung metode IFaceA yang digunakan melalui antarmuka IFaceB.

Untuk setiap metode dalam antarmuka dalam file IDL saat ini, file proksi berisi dua metode pengganti berikut saat dikompilasi dalam mode campuran (/Os), dan data penerjemah yang setara saat dikompilasi dalam mode penerjemah (/Oi).

• Pengganti sisi klien, seperti IFaceB_Method_Proxy dalam contoh ini.

  Surrogat sisi klien ini adalah titik masuk virtual ke mana klien, misalnya IFaceB::Method, mengirimkan panggilan. Ini mengubah argumen input ke dalam bentuk yang dapat ditransmisikan, lalu mengirimkan argumen yang telah dibentuk beserta informasi yang mengidentifikasi antarmuka dan operasi, dan kemudian mengurai nilai pengembalian serta argumen output apa pun ketika operasi yang dijalankan selesai.

• Pengganti fungsi sisi server, misalnya, IFaceB_Method_Stub.

  Pengganti sisi server ini adalah titik masuk virtual yang dikirimkan runtime yang mendasarinya ke server untuk meniru klien. Ini menguraikan argumen input untuk mereplikasi data klien, memanggil implementasi fungsi antarmuka server, dan kemudian memproses serta mengirimkan nilai pengembalian dan argumen output apa pun kembali ke sisi klien.

Nama default untuk file proksi yang dihasilkan dari file.idl adalah file_p.c. Gunakan sakelar MIDL /proxy untuk mengganti nama default file proksi antarmuka. Sakelar /env dan /out memengaruhi file ini.