Función GetVersion (sysinfoapi.h)

  • Artículo

GetVersion puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use las funciones auxiliares de versión. Para obtener Windows 10 aplicaciones, consulte Selección de destino de las aplicaciones para Windows.

Con el lanzamiento de Windows 8.1, el comportamiento de getVersion API ha cambiado en el valor que devolverá para la versión del sistema operativo. El valor devuelto por la función GetVersion depende ahora de cómo se manifiesta la aplicación.

Las aplicaciones que no se manifiestan para Windows 8.1 o Windows 10 devolverán el valor de versión del sistema operativo Windows 8 (6.2). Una vez que una aplicación se manifiesta para una versión de sistema operativo determinada, GetVersion siempre devolverá la versión para la que se manifiesta la aplicación en futuras versiones. Para manifestar las aplicaciones para Windows 8.1 o Windows 10, consulte Selección de destino de la aplicación para Windows.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE DWORD GetVersion();

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto incluye los números de versión principal y secundaria del sistema operativo en la palabra de orden bajo e información sobre la plataforma del sistema operativo en la palabra de orden superior.

Para todas las plataformas, la palabra de orden bajo contiene el número de versión del sistema operativo. El byte de orden bajo de esta palabra especifica el número de versión principal, en notación hexadecimal. El byte de orden superior especifica el número de versión secundaria (revisión), en notación hexadecimal. El bit de orden superior es cero, los 7 bits siguientes representan el número de compilación y el byte de orden bajo es 5.

Comentarios

La función GetVersionEx se desarrolló porque muchas aplicaciones existentes se equivocan al examinar el valor DWORD empaquetado devuelto por GetVersion, transponiendo los números de versión principal y secundaria. GetVersionEx obliga a las aplicaciones a examinar explícitamente cada elemento de información de versión. VerifyVersionInfo elimina más posibilidades de error comparando la versión del sistema necesaria con la versión actual del sistema.

Ejemplos

En el fragmento de código siguiente se muestra cómo extraer información del valor devuelto getVersion : OSVERSIONINFOEX

#include <windows.h>
#include <stdio.h>

void main()
{
    DWORD dwVersion = 0; 
    DWORD dwMajorVersion = 0;
    DWORD dwMinorVersion = 0; 
    DWORD dwBuild = 0;

    dwVersion = GetVersion();
 
    // Get the Windows version.

    dwMajorVersion = (DWORD)(LOBYTE(LOWORD(dwVersion)));
    dwMinorVersion = (DWORD)(HIBYTE(LOWORD(dwVersion)));

    // Get the build number.

    if (dwVersion < 0x80000000)              
        dwBuild = (DWORD)(HIWORD(dwVersion));

    printf("Version is %d.%d (%d)\n", 
                dwMajorVersion,
                dwMinorVersion,
                dwBuild);
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado sysinfoapi.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también