atribut version

Atribut rozhraní [version] identifikuje konkrétní verzi mezi více verzemi rozhraní RPC. Pomocí atributu verze zajistíte, že vazbu smí svázat pouze kompatibilní verze klientského a serverového softwaru.

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

Parametry

hlavní hodnota

Určuje krátké celé číslo bez znaménka mezi nulou a 65 535 (včetně), které představuje číslo hlavní verze.

menší hodnota

Určuje krátké celé číslo bez znaménka mezi nulou a 65 535 včetně, které představuje číslo podverze. Hodnota podverze je volitelná. Pokud existuje, hodnota podverze je oddělená od čísla hlavní verze znakem tečky (.). Pokud není zadána, hodnota podverze je nula.

Poznámky

Kompilátor MIDL nepodporuje více verzí rozhraní MODELU COM. V důsledku toho seznam atributů rozhraní, který obsahuje atribut [object] nemůže obsahovat atribut [version]. Pokud chcete vytvořit novou verzi existujícího rozhraní MODELU COM, použijte dědičnost rozhraní. Odvozené rozhraní MODELU COM má jiné UUID, ale dědí členské funkce rozhraní, stavové kódy a atributy rozhraní základního rozhraní.

V kombinaci s hodnotou [uuid] hodnota [version] jednoznačně identifikuje rozhraní. Knihovna runtime předává hodnoty [version] a [uuid] serveru, když klient volá vzdálenou funkci. Klient může vytvořit vazbu na server pro dané rozhraní, pokud:

• Hodnota [uuid] je stejná.
• Číslo hlavní verze je stejné.
• Číslo podverze klienta je menší nebo rovno číslu podverze serveru.

Vaším přínosem a výhodou uživatelů je zachování kompatibility mezi verzemi, která umožňuje upravit rozhraní tak, aby se změnilo pouze číslo podverze. Kompatibilitu můžete zachovat vzhůru, když přidáte nové datové typy, které stávající funkce nepoužívají, a když přidáte nové funkce beze změny specifikace rozhraní pro existující funkce.

Pokud platí některá z následujících podmínek, změňte číslo hlavní verze:

• Pokud změníte datový typ, který používá existující funkce.
• Pokud změníte specifikaci rozhraní pro existující funkci (například přidání nebo odebrání parametru).
• Pokud přidáte zpětná volání, která jsou volána existujícími funkcemi.

Pokud platí všechny následující podmínky, změňte číslo podverze:

• Pokud přidáte definice typů nebo konstanty, které nejsou používány žádnými existujícími funkcemi nebo zpětnými voláními.
• Pokud nezměníte žádné existující funkce a do rozhraní přidáte nové funkce.
• Pokud přidáte zpětná volání, která nejsou volána žádnými existujícími funkcemi, a nové zpětné volání následují všechny existující funkce.

Pokud vaše úpravy odpovídají přechodu na rozhraní vzhůru, použijte následující postup.

Úprava souboru rozhraní (IDL)

1. Do souboru rozhraní přidejte nové definice konstanty a typu.
2. Na konec souboru rozhraní přidejte funkce zpětného volání.
3. Na konec souboru rozhraní přidejte nové funkce.

Atribut [version] může v hlavičce rozhraní nastat nejvýše jednou.

Pokud atribut verze není k dispozici, rozhraní má výchozí verzi 0.0.

Znak tečky mezi hlavními a vedlejšími čísly je oddělovač a nepředstavuje desetinnou čárku. Menší číslo se považuje za celé číslo. Úvodní nuly nejsou významné. Koncové nuly jsou významné.

Například nastavení verze 1.11 představuje hlavní hodnotu jedné a podverze jedenáct. Verze 1.11 nepředstavuje hodnotu mezi 1.1 a 1.2.

Viz také

Soubor definice rozhraní (IDL)

Rozhraní

Objekt

Uuid