Bagikan melalui


atribut versi

Atribut antarmuka [versi] mengidentifikasi versi tertentu di antara beberapa versi antarmuka RPC. Dengan atribut versi, Anda memastikan bahwa hanya versi perangkat lunak klien dan server yang kompatibel yang diizinkan untuk mengikat.

version ( major-value[[. minor-value]] )

Parameter

nilai utama

Menentukan bilangan bulat pendek yang tidak ditandatangani antara nol dan 65.535, inklusif, yang mewakili nomor versi utama.

nilai minor

Menentukan bilangan bulat pendek yang tidak ditandatangani antara nol dan 65.535, inklusif, yang mewakili nomor versi minor. Nilai versi minor bersifat opsional. Jika ada, nilai versi minor dipisahkan dari nomor versi utama dengan karakter titik (.). Jika tidak ditentukan, nilai versi minor adalah nol.

Keterangan

Pengkompilasi MIDL tidak mendukung beberapa versi antarmuka COM. Akibatnya, daftar atribut antarmuka yang menyertakan atribut [objek] tidak dapat menyertakan atribut [versi ]. Untuk membuat versi baru antarmuka COM yang ada, gunakan pewarisan antarmuka. Antarmuka COM turunan memiliki UUID yang berbeda tetapi mewarisi fungsi anggota antarmuka, kode status, dan atribut antarmuka antarmuka antarmuka dasar.

Dalam kombinasi dengan nilai [uuid] , nilai [versi] secara unik mengidentifikasi antarmuka. Pustaka run-time meneruskan nilai [version] dan [uuid] ke server saat klien memanggil fungsi jarak jauh. Klien dapat mengikat server untuk antarmuka tertentu jika:

  • Nilai [uuid] sama.
  • Nomor versi utama sama.
  • Nomor versi minor klien kurang dari atau sama dengan nomor versi minor server.

Ini untuk keuntungan Anda dan manfaat pengguna Anda untuk mempertahankan kompatibilitas ke atas di antara versi yaitu, untuk memodifikasi antarmuka sehingga hanya nomor versi minor yang berubah. Anda dapat mempertahankan kompatibilitas ke atas saat menambahkan jenis data baru yang tidak digunakan oleh fungsi yang ada dan saat Anda menambahkan fungsi baru tanpa mengubah spesifikasi antarmuka untuk fungsi yang ada.

Ubah nomor versi utama jika salah satu kondisi berikut berlaku:

  • Jika Anda mengubah jenis data yang digunakan oleh fungsi yang sudah ada.
  • Jika Anda mengubah spesifikasi antarmuka untuk fungsi yang ada (seperti menambahkan atau menghapus parameter).
  • Jika Anda menambahkan panggilan balik yang dipanggil oleh fungsi yang ada.

Ubah nomor versi minor jika semua kondisi berikut berlaku:

  • Jika Anda menambahkan definisi jenis atau konstanta yang tidak digunakan oleh fungsi atau panggilan balik yang ada.
  • Jika Anda tidak mengubah fungsi yang ada dan Menambahkan fungsi baru ke antarmuka.
  • Jika Anda menambahkan panggilan balik yang tidak dipanggil oleh fungsi yang ada dan panggilan balik baru mengikuti fungsi yang ada.

Jika modifikasi Anda memenuhi syarat sebagai perubahan yang kompatibel ke atas ke antarmuka, gunakan prosedur berikut.

Untuk mengubah file antarmuka (IDL)

  1. Tambahkan definisi konstanta dan jenis baru ke file antarmuka.
  2. Tambahkan fungsi panggilan balik ke akhir file antarmuka.
  3. Tambahkan fungsi baru ke akhir file antarmuka.

Atribut [versi] dapat terjadi paling banyak sekali di header antarmuka.

Ketika atribut versi tidak ada, antarmuka memiliki versi default 0.0.

Karakter titik antara angka utama dan minor adalah pemisah dan tidak mewakili titik desimal. Angka minor diperlakukan sebagai bilangan bulat. Nol di depan tidak signifikan. Nol berikutnya sangat signifikan.

Misalnya, pengaturan versi 1.11 mewakili nilai utama satu dan nilai minor sebelas. Versi 1.11 tidak mewakili nilai antara 1.1 dan 1.2.

Lihat juga

File Definisi Antarmuka (IDL)

Antarmuka

Objek

uuid