Estructura OSVERSIONINFOEXW (winnt.h)

Contiene información de la versión del sistema operativo. La información incluye números de versión principales y secundarias, un número de compilación, un identificador de plataforma e información sobre los conjuntos de productos y el Service Pack más reciente instalado en el sistema. Esta estructura se usa con las funciones GetVersionEx y VerifyVersionInfo .

Sintaxis

typedef struct _OSVERSIONINFOEXW {
  DWORD dwOSVersionInfoSize;
  DWORD dwMajorVersion;
  DWORD dwMinorVersion;
  DWORD dwBuildNumber;
  DWORD dwPlatformId;
  WCHAR szCSDVersion[128];
  WORD  wServicePackMajor;
  WORD  wServicePackMinor;
  WORD  wSuiteMask;
  BYTE  wProductType;
  BYTE  wReserved;
} OSVERSIONINFOEXW, *POSVERSIONINFOEXW, *LPOSVERSIONINFOEXW, RTL_OSVERSIONINFOEXW, *PRTL_OSVERSIONINFOEXW;

Miembros

dwOSVersionInfoSize

Tamaño de esta estructura de datos, en bytes. Establezca este miembro en sizeof(OSVERSIONINFOEX).

dwMajorVersion

Número de versión principal del sistema operativo. Para obtener más información, vea la sección Comentarios.

dwMinorVersion

Número de versión secundaria del sistema operativo. Para obtener más información, vea la sección Comentarios.

dwBuildNumber

Número de compilación del sistema operativo.

dwPlatformId

La plataforma del sistema operativo. Este miembro puede ser VER_PLATFORM_WIN32_NT (2).

szCSDVersion[128]

Cadena terminada en null, como "Service Pack 3", que indica el Service Pack más reciente instalado en el sistema. Si no se ha instalado ningún Service Pack, la cadena está vacía.

wServicePackMajor

Número de versión principal del Service Pack más reciente instalado en el sistema. Por ejemplo, para Service Pack 3, el número de versión principal es 3. Si no se ha instalado ningún Service Pack, el valor es cero.

wServicePackMinor

Número de versión secundaria del Service Pack más reciente instalado en el sistema. Por ejemplo, para Service Pack 3, el número de versión secundaria es 0.

wSuiteMask

Máscara de bits que identifica los conjuntos de productos disponibles en el sistema. Este miembro puede ser una combinación de los valores siguientes.

wProductType

Cualquier información adicional sobre el sistema. Este miembro puede ser uno de los valores siguientes.

wReserved

Reservado para uso futuro.

Comentarios

Confiar en la información de versión no es la mejor manera de probar una característica. En su lugar, consulte la documentación de la característica de interés. Para obtener más información sobre las técnicas comunes para la detección de características, consulte Versión del sistema operativo.

Si necesita un sistema operativo determinado, asegúrese de usarlo como una versión mínima admitida, en lugar de diseñar la prueba para un sistema operativo. De este modo, el código de detección seguirá funcionando en versiones futuras de Windows.

En la tabla siguiente se resumen los valores devueltos por las versiones compatibles de Windows. Use la información de la columna con la etiqueta "Other" para distinguir entre sistemas operativos con números de versión idénticos.

No debe confiar solo en la marca VER_SUITE_SMALLBUSINESS para determinar si Small Business Server se ha instalado en el sistema, ya que esta marca y la marca de VER_SUITE_SMALLBUSINESS_RESTRICTED se establecen cuando se instala este conjunto de productos. Si actualiza esta instalación a Windows Server, Standard Edition, se borrará la marca de VER_SUITE_SMALLBUSINESS_RESTRICTED ; sin embargo, la marca de VER_SUITE_SMALLBUSINESS permanecerá establecida. En este caso, esto indica que Small Business Server se instaló una vez en este sistema. Si esta instalación se actualiza aún más a Windows Server, Enterprise Edition, la marca VER_SUITE_SMALLBUSINESS permanecerá establecida.

Si el modo de compatibilidad está en vigor, la estructura OSVERSIONINFOEX contiene información sobre el sistema operativo seleccionado para la compatibilidad de aplicaciones.

Para determinar si una aplicación basada en Win32 se ejecuta en WOW64, llame a la función IsWow64Process . Para determinar si el sistema ejecuta una versión de 64 bits de Windows, llame a la función GetNativeSystemInfo .

La función GetSystemMetrics proporciona la siguiente información adicional sobre el sistema operativo actual.

Ejemplos

Para obtener un ejemplo, consulte Obtención de la versión del sistema.

Requisitos

Consulte también

IsWow64Process

OSVERSIONINFO

API del asistente de versiones