versionsattribut

Gränssnittsattributet [version] identifierar en viss version bland flera versioner av ett RPC-gränssnitt. Med versionsattributet ser du till att endast kompatibla versioner av klient- och serverprogramvara tillåts binda.

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

Parameters

major-value

Anger ett kort osignerat heltal mellan noll och 65 535, inklusive, som representerar huvudversionsnumret.

mindre värde

Anger ett kort osignerat heltal mellan noll och 65 535, inklusive, som representerar delversionsnumret. Delversionsvärdet är valfritt. Om det finns, avgränsas delversionsvärdet från huvudversionsnumret med ett periodtecken (.). Om det inte anges är delversionsvärdet noll.

Anmärkningar

MIDL-kompilatorn stöder inte flera versioner av ett COM-gränssnitt. Därför kan en lista över gränssnittsattribut som innehåller attributet [object] inte innehålla attributet [version]. Om du vill skapa en ny version av ett befintligt COM-gränssnitt använder du arv av gränssnitt. Ett härlett COM-gränssnitt har ett annat UUID men ärver gränssnittsmedlemsfunktionerna, statuskoderna och gränssnittsattributen för basgränssnittet.

I kombination med värdet [uuid] identifierar värdet [version] gränssnittet unikt. Körningsbiblioteket skickar värdena [version] och [uuid] till servern när klienten anropar en fjärrfunktion. En klient kan binda till en server för ett visst gränssnitt om:

• Värdet [uuid] är detsamma.
• Huvudversionsnumret är detsamma.
• Klientens delversionsnummer är mindre än eller lika med serverns delversionsnummer.

Det är till din fördel och användarnas fördel att behålla kompatibilitet uppåt mellan versioner, dvs. att ändra gränssnittet så att endast delversionsnumret ändras. Du kan behålla kompatibilitet uppåt när du lägger till nya datatyper som inte används av befintliga funktioner och när du lägger till nya funktioner utan att ändra gränssnittsspecifikationen för befintliga funktioner.

Ändra huvudversionsnumret om något av följande villkor gäller:

• Om du ändrar en datatyp som används av en befintlig funktion.
• Om du ändrar gränssnittsspecifikationen för en befintlig funktion (till exempel att lägga till eller ta bort en parameter).
• Om du lägger till motringningar som anropas av befintliga funktioner.

Ändra delversionsnumret om alla följande villkor gäller:

• Om du lägger till typdefinitioner eller konstanter som inte används av några befintliga funktioner eller återanrop.
• Om du inte ändrar några befintliga funktioner och lägger till nya funktioner i gränssnittet.
• Om du lägger till återanrop som inte anropas av några befintliga funktioner och de nya återanropen följer några befintliga funktioner.

Om dina ändringar kvalificerar sig som en uppåtkompatibel ändring av gränssnittet använder du följande procedur.

Så här ändrar du gränssnittsfilen (IDL)

1. Lägg till nya konstant- och typdefinitioner i gränssnittsfilen.
2. Lägg till återanropsfunktioner i slutet av gränssnittsfilen.
3. Lägg till nya funktioner i slutet av gränssnittsfilen.

Attributet [version] kan inträffa högst en gång i gränssnittsrubriken.

När versionsattributet inte finns har gränssnittet en standardversion av 0.0.

Periodtecknet mellan de större och mindre talen är en avgränsare och representerar inte en decimalpunkt. Det mindre talet behandlas som ett heltal. Inledande noller är inte signifikanta. Avslutande nollorna är betydande.

Versionsinställningen 1.11 representerar till exempel ett huvudvärde på ett och ett mindre värde på elva. Version 1.11 representerar inte ett värde mellan 1.1 och 1.2.

Se även

IDL-fil (Interface Definition)

Gränssnitt

Objekt

Uuid