Versiones de DLL de Shell y Shlwapi

  • Artículo

En esta sección se describe cómo determinar en qué versión de los archivos DLL de Shell se ejecuta la aplicación y cómo seleccionar como destino la aplicación para una versión específica.

Números de versión de DLL

Todos los elementos de programación que se describen en la documentación de Shell están incluidos en dos archivos DLL: Shell32.dll y Shlwapi.dll. Debido a las mejoras continuas, las distintas versiones de estos archivos DLL implementan características diferentes. A lo largo de la documentación de referencia de Shell, cada elemento de programación especifica un número de versión de DLL mínimo admitido. Este número de versión indica que el elemento de programación se implementa en esa versión y versiones posteriores del archivo DLL a menos que se especifique lo contrario. Si no se especifica ningún número de versión, el elemento de programación se implementa en todas las versiones existentes del archivo DLL.

Antes de Windows XP, a veces se proporcionaban nuevas versiones de Shell32.dll y Shlwapi.dll con nuevas versiones de Windows Internet Explorer. A partir de Windows XP, esos archivos DLL ya no se proporcionaron como archivos redistribuibles fuera de las nuevas versiones de Windows. En la tabla siguiente se describen las distintas versiones dll y cómo se distribuyeron a partir de Microsoft Internet Explorer 3.0, Windows 95 y Microsoft Windows NT 4.0.

Shell32.dll versión 4.0 se encuentra en las versiones originales de Windows 95 y Microsoft Windows NT 4.0. El Shell no se actualizó con la versión de Internet Explorer 3.0, por lo que Shell32.dll no tiene una versión 4.70. Shell32.dll las versiones 4.71 y 4.72 se enviaron con las versiones correspondientes de Internet Explorer, pero no se instalaron necesariamente (consulte la nota 1). Para versiones posteriores a Microsoft Internet Explorer 4.01 y Windows 98, los números de versión de Shell32.dll y Shlwapi.dll diverge. En general, debe suponer que los archivos DLL tienen números de versión diferentes y probar cada uno por separado.

Shell32.dll

Versión Plataforma de distribución
4.0 Windows 95 y Microsoft Windows NT 4.0
4.71 Microsoft Internet Explorer 4.0. Vea la nota 1.
4.72 Internet Explorer 4.01 y Windows 98. Vea la nota 1.
5.0 Windows 2000 y Windows Millennium Edition (Windows Me). Consulte la nota 2.
6,0 Windows XP
6.0.1 Windows Vista
6.1 Windows 7

Shlwapi.dll

Versión Plataforma de distribución
4.0 Windows 95 y Microsoft Windows NT 4.0
4.71 Internet Explorer 4.0. Vea la nota 1.
4.72 Internet Explorer 4.01 y Windows 98. Vea la nota 1.
4,7 Internet Explorer 3.x
5.0 Microsoft Internet Explorer 5 y Windows 98 SE. Consulte la nota 2.
5.5 Microsoft Internet Explorer 5.5 y Windows Millennium Edition (Windows Me)
6,0 Windows XP y Windows Vista

Nota 1: Todos los sistemas con Internet Explorer 4.0 o 4.01 tenían la versión asociada de Shlwapi.dll (4.71 o 4.72, respectivamente). Sin embargo, para sistemas anteriores a Windows 98, Internet Explorer 4.0 y 4.01 se pueden instalar con o sin lo que se conocía como shell integrado. Si Internet Explorer se instaló con el Shell integrado, también se instaló la versión asociada de Shell32.dll (4.71 o 4.72). Si Internet Explorer se instaló sin el Shell integrado, Shell32.dll permaneció como versión 4.0. En otras palabras, la presencia de la versión 4.71 o 4.72 de Shlwapi.dll en un sistema no garantiza que Shell32.dll tenga el mismo número de versión. Todos los sistemas Windows 98 tienen la versión 4.72 de Shell32.dll.

Nota 2: La versión 5.0 de Shlwapi.dll se distribuyó con Internet Explorer 5 y se encontró en todos los sistemas en los que se instaló Internet Explorer 5, con la excepción de Windows 2000. La versión 5.0 de Shell32.dll se distribuyó de forma nativa con Windows 2000 y Windows Millennium Edition (Windows Me), junto con la versión 5.0 de Shlwapi.dll.

Uso de DllGetVersion para determinar el número de versión

A partir de la versión 4.71, los archivos DLL de Shell, entre otros, comenzaron a exportar DllGetVersion. Una aplicación puede llamar a esta función para determinar qué versión de DLL está presente en el sistema.

Nota

Los archivos DLL no exportan necesariamente DllGetVersion. Pruebe siempre para ello antes de intentar usarlo.

Para las versiones de Windows anteriores a Windows 2000, DllGetVersion devuelve una estructura DLLVERSIONINFO que contiene los números de versión principal y secundaria, el número de compilación y un identificador de plataforma. En el caso de los sistemas Windows 2000 y versiones posteriores, DllGetVersion podría devolver en su lugar una estructura DLLVERSIONINFO2 . Además de la información proporcionada a través de DLLVERSIONINFO, DLLVERSIONINFO2también proporciona el número de revisión que identifica el Service Pack instalado más reciente, que proporciona una manera más sólida de comparar los números de versión. Dado que el primer miembro de DLLVERSIONINFO2 es una estructura DLLVERSIONINFO , la estructura posterior es compatible con versiones anteriores.

Uso de DllGetVersion

La siguiente función GetVersion de ejemplo carga un archivo DLL especificado e intenta llamar a su función DllGetVersion . Si se ejecuta correctamente, usa una macro para empaquetar los números de versión principal y secundaria de la estructura DLLVERSIONINFO en un DWORD que se devuelve a la aplicación que realiza la llamada. Si el archivo DLL no exporta DllGetVersion, la función devuelve cero. Con windows 2000 y sistemas posteriores, puedes modificar la función para controlar la posibilidad de que DllGetVersion devuelva una estructura DLLVERSIONINFO2 . Si es así, use la información de ese miembro ullVersion de la estructura DLLVERSION2 para comparar versiones, números de compilación y versiones de Service Pack. La macro MAKEDLLVERULL simplifica la tarea de comparar estos valores con los de ullVersion.

Nota

El uso incorrecto de LoadLibrary puede suponer riesgos de seguridad. Consulte la documentación de LoadLibrary para obtener información sobre cómo cargar correctamente archivos DLL con diferentes versiones de Windows.

#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;
}

En el ejemplo de código siguiente se muestra cómo se puede usar GetVersion para probar si Shell32.dll es la versión 6.0 o posterior.

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

if(dwVer >= dwTarget)
{
    // This version of Shell32.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.
}

Versiones del proyecto

Para asegurarse de que la aplicación es compatible con diferentes versiones de destino de un archivo .dll, las macros de versión están presentes en los archivos de encabezado. Estas macros se usan para definir, excluir o redefinir determinadas definiciones para distintas versiones del archivo DLL. Consulta Usar los encabezados de Windows para obtener una descripción detallada de estas macros.

Por ejemplo, el nombre de macro _WIN32_IE se encuentra normalmente en encabezados anteriores. Es responsable de definir la macro como un número hexadecimal. Este número de versión define la versión de destino de la aplicación que usa el archivo DLL. En la tabla siguiente se muestran los números de versión disponibles y el efecto que tiene cada uno en la aplicación.

Versión Descripción
0x0200 La aplicación es compatible con Shell32.dll versión 4.00 y posteriores. La aplicación no puede implementar características que se agregaron después de la versión 4.00.
0x0300 La aplicación es compatible con Shell32.dll versión 4.70 y posteriores. La aplicación no puede implementar características que se agregaron después de la versión 4.70.
0x0400 La aplicación es compatible con Shell32.dll versión 4.71 y posteriores. La aplicación no puede implementar características que se agregaron después de la versión 4.71.
0x0401 La aplicación es compatible con Shell32.dll versión 4.72 y posteriores. La aplicación no puede implementar características que se agregaron después de la versión 4.72.
0x0500 La aplicación es compatible con Shell32.dll y Shlwapi.dll versión 5.0 y posteriores. La aplicación no puede implementar características que se agregaron después de la versión 5.0 de Shell32.dll y Shlwapi.dll.
0x0501 La aplicación es compatible con Shell32.dll y Shlwapi.dll versión 5.0 y posteriores. La aplicación no puede implementar características que se agregaron después de la versión 5.0 de Shell32.dll y Shlwapi.dll.
0x0600 La aplicación es compatible con Shell32.dll y Shlwapi.dll versión 6.0 y posteriores. La aplicación no puede implementar características que se agregaron después de la versión 6.0 de Shell32.dll y Shlwapi.dll.

Si no define la macro _WIN32_IE en el proyecto, se define automáticamente como 0x0500. Para definir un valor diferente, puede agregar lo siguiente a las directivas del compilador en el archivo make; sustituya el número de versión deseado para 0x0400.

/D _WIN32_IE=0x0400

Otro método consiste en agregar una línea similar a la siguiente en el código fuente antes de incluir los archivos de encabezado de Shell. Sustituya el número de versión deseado por 0x0400.

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