Gyakori vezérlőverziók

Ez a témakör a Common Control könyvtár elérhető verzióit (ComCtl32.dll) sorolja fel, ismerteti, hogyan azonosíthatja az alkalmazás által használt verziót, és ismerteti, hogyan célozhatja meg az alkalmazást egy adott verzióra.

Ez a témakör a következő szakaszokat tartalmazza.

• gyakori vezérlő DLL-verziók számai
• különböző közös vezérlőverziók szerkezetméretei
• DllGetVersion használata a verziószám meghatározásához
• Projektverziók
• Kapcsolódó témakörök

A vezérlő DLL-verzióinak gyakori számai

A gyakori vezérlők támogatását a ComCtl32.dllbiztosítja, amelyet a Windows mind a 32 bites és a 64 bites verziója tartalmaz. A DLL minden egymást követő verziója támogatja a korábbi verziók funkcióit és API-ját, és új funkciókat ad hozzá.

Mivel a ComCtl32.dll különböző verzióit terjesztették az Internet Explorerrel, az aktív verzió néha eltér az operációs rendszerrel szállított verziótól. Ezért az alkalmazásnak közvetlenül meg kell határoznia, hogy a ComCtl32.dll melyik verziója van jelen.

A közös vezérlők referenciadokumentációjában számos programozási elem meghatároz egy minimálisan támogatott DLL-verziószámot. Ez a verziószám azt jelzi, hogy a programozási elem az adott verzióban és a DLL későbbi verzióiban van implementálva, kivéve, ha másként van megadva. Ha nincs megadva verziószám, a programozási elem a DLL összes meglévő verziójában implementálva lesz.

Az alábbi táblázat a különböző DLL-verziókat és azok támogatott operációs rendszereken való terjesztésének módját ismerteti.

ComCtl32.dll

Verzió

Terjesztési platform

5.81

Microsoft Internet Explorer 5.01, Microsoft Internet Explorer 5.5 és Microsoft Internet Explorer 6

5.82

Windows Server 2003, Windows Vista, Windows Server 2008 és Windows 7

6.0

Windows Server 2003

6.10

Windows Vista, Windows Server 2008 és Windows 7

Struktúraméretek különböző gyakori vezérlőverziókhoz

A közös vezérlők folyamatos fejlesztései miatt számos struktúrát ki kell terjeszteni. Ezért a struktúrák mérete a Commctrl.h különböző verziói között megváltozott. Mivel a gyakran használt vezérlőstruktúrák többsége egy struktúraméretet használ a paraméterek egyikeként, egy üzenet vagy függvény meghiúsulhat, ha a méretet nem ismeri fel a rendszer. Ennek orvoslása érdekében a szerkezet méretállandóit úgy határoztuk meg, hogy segítsük a ComCtl32.dllkülönböző verziójának megcélzását. Az alábbi lista a struktúra méretállandóit határozza meg.

A DllGetVersion használata a verziószám meghatározásához

Az alkalmazás meghívhatja a DllGetVersion függvényt annak megállapításához, hogy melyik DLL-verzió található a rendszeren.

DllGetVersion egy DLLVERSIONINFO2 struktúrát ad vissza. A DLLVERSIONINFOáltal biztosított információk mellett DLLVERSIONINFO2 a legújabb telepített szervizcsomagot azonosító gyorsjavítási számot is biztosítja, amely robusztusabb módot kínál a verziószámok összehasonlítására. Mivel a DLLVERSIONINFO2 első tagja egy DLLVERSIONINFO struktúra, a későbbi struktúra visszamenőlegesen kompatibilis.

Az alábbi mintafüggvény egy megadott DLL-t tölt be GetVersion, és megpróbálja meghívni a DllGetVersion függvényt. Ha sikeres, makróval csomagolja be a fő- és alverziószámokat a DLLVERSIONINFO struktúrából egy DWORD, amelyet a rendszer visszaad a hívó alkalmazásnak. Ha a DLL nem exportálja DllGetVersion, a függvény nullát ad vissza. Módosíthatja a függvényt annak a lehetőségnek a kezelésére, hogy DllGetVersionDLLVERSIONINFO2 struktúrát ad vissza. Ha igen, használja az adott DLLVERSIONINFO2 szerkezet ullVersion tagjának adatait a verziók, buildszámok és szervizcsomagok kiadásainak összehasonlításához. A MAKEDLLVERULL makró egyszerűbbé teszi ezeknek az értékeknek az összehasonlítását az ullVersion.

#include "stdafx.h"
#include "windows.h"
#include "windef.h"
#include "winbase.h"
#include "shlwapi.h"

#define PACKVERSION(major,minor) MAKELONG(minor,major)

DWORD GetVersion(LPCTSTR lpszDllName)
{
    HINSTANCE hinstDll;
    DWORD dwVersion = 0;

    // For security purposes, LoadLibrary should be provided with a fully qualified 
    // path to the DLL. The lpszDllName variable should be tested to ensure that it 
    // is a fully qualified path before it is used. 
    hinstDll = LoadLibrary(lpszDllName);
    
    if(hinstDll)
    {
        DLLGETVERSIONPROC pDllGetVersion;
        pDllGetVersion = (DLLGETVERSIONPROC)GetProcAddress(hinstDll, "DllGetVersion");

        // Because some DLLs might not implement this function, you must test for 
        // it explicitly. Depending on the particular DLL, the lack of a DllGetVersion 
        // function can be a useful indicator of the version. 

        if(pDllGetVersion)
        {
            DLLVERSIONINFO dvi;
            HRESULT hr;

            ZeroMemory(&dvi, sizeof(dvi));
            dvi.info1.cbSize = sizeof(dvi);

            hr = (*pDllGetVersion)(&dvi);

            if(SUCCEEDED(hr))
            {
               dwVersion = PACKVERSION(dvi.info1.dwMajorVersion, dvi.info1.dwMinorVersion);
            }
        }
        FreeLibrary(hinstDll);
    }
    return dwVersion;
}

Az alábbi példakód bemutatja, hogyan tesztelheti GetVersion, hogy ComCtl32.dll 6.0-s vagy újabb verzió-e.

LPCTSTR lpszDllName = L"C:\\Windows\\System32\\ComCtl32.dll";
DWORD dwVer = GetVersion(lpszDllName);
DWORD dwTarget = PACKVERSION(6,0);

if(dwVer >= dwTarget)
{
    // This version of ComCtl32.dll is version 6.0 or later.
}
else
{
    // Proceed knowing that version 6.0 or later additions are not available.
    // Use an alternate approach for older the DLL version.
}

Projektverziók

Annak érdekében, hogy az alkalmazás kompatibilis legyen egy .dll-fájl különböző célzott verzióival, a fejlécfájlokban verziómakrók találhatók. Ezek a makrók a DLL különböző verzióinak bizonyos definícióinak definiálására, kizárására vagy újradefinitálására szolgálnak. A makrók részletes leírását a A Windows-fejlécek című témakörben talál.

A _WIN32_IE makrónév például gyakran megtalálható a régebbi fejlécekben. A makró hexadecimális számként való definiálásáért Ön a felelős. Ez a verziószám határozza meg a DLL-t használó alkalmazás célverzióját. Az alábbi táblázat az elérhető verziószámokat és az egyes alkalmazásokra gyakorolt hatást mutatja be.

Ha nem definiálja a _WIN32_IE makrót a projektben, az automatikusan 0x0500 ként lesz definiálva. Egy másik érték meghatározásához hozzáadhatja a következőt a fordítási irányelvekhez a fájlban; helyettesítse a kívánt verziószámot a 0x0400.

/D _WIN32_IE=0x0400

Egy másik módszer a következőhöz hasonló sor hozzáadása a forráskódban, mielőtt belefoglalja a Shell-fejlécfájlokat. Cserélje le a kívánt verziószámot a 0x0400.

#define _WIN32_IE 0x0400
#include <commctrl.h>

Kapcsolódó témakörök

A gyakori vezérlők