verzióattribútum

A [verzió] felület attribútum egy adott verziót azonosít egy RPC-felület több verziója között. A verzióattribútummal győződjön meg arról, hogy csak az ügyfél- és kiszolgálószoftver kompatibilis verziói köthetnek.

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

Paraméterek

fő érték

Nulla és 65 535 közötti rövid, alá nem írt egész számot ad meg, amely a fő verziószámot jelöli.

alérték

A nulla és 65 535 közötti rövid, alá nem írt egész számot adja meg, beleértve az alverzió számát. Az alverzió értéke nem kötelező. Ha van ilyen, az alverzió értékét pont karakter (.) választja el a főverzió számától. Ha nincs megadva, az alverzió értéke nulla.

Megjegyzések

A MIDL fordító nem támogatja a COM-felület több verzióját. Ennek eredményeképpen az [object] attribútumot tartalmazó illesztőattribútum-lista nem tartalmazza a [version] attribútumot. Meglévő COM-felület új verziójának létrehozásához használja a felületöröklést. A származtatott COM-felületek eltérő UUID-azonosítóval rendelkezik, de öröklik az alapfelület illesztőtagfüggvényeit, állapotkódjait és felületi attribútumait.

A [uuid] értékkel kombinálva a [verzió] érték egyedileg azonosítja a felületet. A futásidejű kódtár átadja a [version] és a [uuid] értékeket a kiszolgálónak, amikor az ügyfél távoli függvényt hív meg. Az ügyfél a következő esetekben köthet egy kiszolgálóhoz egy adott felülethez:

• A [uuid] érték ugyanaz.
• A fő verziószám ugyanaz.
• Az ügyfél alverziószáma kisebb vagy egyenlő a kiszolgáló alverziószámával.

Az Ön és a felhasználók előnyére szolgál, hogy fenntartsák a kompatibilitást a verziók között, azaz úgy módosítsák a felületet, hogy csak az alverziószám változik. A meglévő függvények által nem használt új adattípusok hozzáadásakor és új függvények hozzáadásakor a meglévő függvények felületi specifikációjának módosítása nélkül is megőrizheti a kompatibilitást.

Módosítsa a főverzió számát, ha az alábbi feltételek valamelyike érvényes:

• Ha egy meglévő függvény által használt adattípust módosít.
• Ha módosítja egy meglévő függvény felületi specifikációját (például paraméter hozzáadását vagy eltávolítását).
• Ha meglévő függvények által hívott visszahívásokat ad hozzá.

Módosítsa az alverzió számát, ha az alábbi feltételek teljesülnek:

• Ha olyan típusdefiníciókat vagy állandókat ad hozzá, amelyeket a meglévő függvények vagy visszahívások nem használnak.
• Ha nem módosítja a meglévő függvényeket, és új függvényeket ad hozzá a felülethez.
• Ha olyan visszahívásokat ad hozzá, amelyeket egyetlen meglévő függvény sem hív meg, és az új visszahívások a meglévő függvényeket követik.

Ha a módosítások felfelé kompatibilis módosításnak minősülnek az interfészen, kövesse az alábbi eljárást.

Az interfészfájl (IDL) módosítása

1. Adjon hozzá új állandó- és típusdefiníciókat a felületfájlhoz.
2. Adja hozzá a visszahívási függvényeket a felületfájl végéhez.
3. Adjon hozzá új függvényeket a felületfájl végéhez.

A [version] attribútum legfeljebb egyszer fordulhat elő a felület fejlécében.

Ha a verzióattribútum nem jelenik meg, a felület alapértelmezett 0.0-s verziójával rendelkezik.

A fő- és alszámok közötti pont karakter elválasztó, és nem tizedesvesszőt jelöl. Az alszám egész számként van kezelve. A kezdő nullák nem jelentősek. A záró nullák jelentősek.

Az 1.11-es verzióbeállítás például egy fő értéket, egy kisebb 11-es értéket jelöl. Az 1.11-es verzió nem jelent 1.1 és 1.2 közötti értéket.

Lásd még

Interfészdefiníciós (IDL-) fájl

Felület

Objektum

Uuid