sürüm özniteliği

[version] arabirim özniteliği, rpc arabiriminin birden çok sürümü arasında belirli bir sürümü tanımlar. sürüm özniteliğiyle, istemci ve sunucu yazılımının yalnızca uyumlu sürümlerinin bağlanmasına izin verildiğinden emin olursunuz.

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

Parametreler

ana değer

Ana sürüm numarasını temsil eden sıfır ile 65.535 (dahil) arasında kısa bir işaretsiz tamsayı belirtir.

küçük değer

İkincil sürüm numarasını temsil eden sıfır ile 65.535 (dahil) arasında kısa bir işaretsiz tamsayı belirtir. İkincil sürüm değeri isteğe bağlıdır. Varsa, ikincil sürüm değeri ana sürüm numarasından bir nokta karakteri (.) ile ayrılır. Belirtilmezse, ikincil sürüm değeri sıfırdır.

Açıklamalar

MIDL derleyicisi, COM arabiriminin birden çok sürümünü desteklemez. Sonuç olarak, [object] özniteliğini içeren bir arabirim öznitelik listesi [version] özniteliğini içeremez. Mevcut com arabiriminin yeni bir sürümünü oluşturmak için arabirim devralmayı kullanın. Türetilmiş com arabirimi farklı bir UUID'ye sahiptir, ancak temel arabirimin arabirim üyesi işlevlerini, durum kodlarını ve arabirim özniteliklerini devralır.

[uuid] değeriyle birlikte, [version] değeri arabirimi benzersiz olarak tanımlar. çalışma zamanı kitaplığı, istemci bir uzak işlevi çağırdığında [version] ve [uuid] değerlerini sunucuya geçirir. İstemci, aşağıdakiler durumunda belirli bir arabirim için bir sunucuya bağlanabilir:

• [uuid] değeri aynıdır.
• Ana sürüm numarası aynıdır.
• İstemcinin ikincil sürüm numarası sunucunun ikincil sürüm numarasından küçük veya ona eşittir.

Yalnızca ikincil sürüm numarasının değişmesi için arabirimi değiştirmek, sürümler arasında yukarı doğru uyumluluğu korumak sizin ve kullanıcılarınızın yararınadır. Mevcut işlevler tarafından kullanılmayan yeni veri türleri eklediğinizde ve var olan işlevlerin arabirim belirtimini değiştirmeden yeni işlevler eklediğinizde yukarı doğru uyumluluğu koruyabilirsiniz.

Aşağıdaki koşullardan biri geçerliyse ana sürüm numarasını değiştirin:

• Mevcut bir işlev tarafından kullanılan bir veri türünü değiştirirseniz.
• Mevcut bir işlevin arabirim belirtimini değiştirirseniz (parametre ekleme veya kaldırma gibi).
• Mevcut işlevler tarafından çağrılan geri çağırmalar eklerseniz.

Aşağıdaki koşulların tümü geçerliyse ikincil sürüm numarasını değiştirin:

• Varolan işlevler veya geri çağırmalar tarafından kullanılmayan tür tanımları veya sabitleri eklerseniz.
• Mevcut işlevleri değiştirmezseniz ve arabirime yeni işlevler eklerseniz.
• Mevcut işlevler tarafından çağrılmayan geri çağırmalar eklerseniz ve yeni geri çağırmalar mevcut işlevleri izler.

Değişiklikleriniz arabirimde yukarı uyumlu bir değişiklik olarak nitelendirildiyse aşağıdaki yordamı kullanın.

Arabirim (IDL) dosyasını değiştirmek için

1. Arabirim dosyasına yeni sabit ve tür tanımları ekleyin.
2. Arabirim dosyasının sonuna geri çağırma işlevleri ekleyin.
3. Arabirim dosyasının sonuna yeni işlevler ekleyin.

[version] özniteliği, arabirim üst bilgisinde en fazla bir kez oluşabilir.

Sürüm özniteliği olmadığında, arabirim varsayılan 0.0 sürümüne sahiptir.

Ana ve ikincil sayılar arasındaki nokta karakteri bir sınırlayıcıdır ve ondalık ayırıcıyı temsil etmez. İkincil sayı tamsayı olarak değerlendirilir. Baştaki sıfırlar önemli değildir. Sondaki sıfırlar önemlidir.

Örneğin, sürüm ayarı 1.11 bir ana değeri ve alt değeri on bir temsil eder. Sürüm 1.11, 1.1 ile 1.2 arasındaki bir değeri temsil etmez.

Ayrıca bakınız

Arabirim Tanımı (IDL) Dosyası

Arabirim

Nesne

Uuıd