Struttura OSVERSIONINFOEXW (wdm.h)

La struttura RTL_OSVERSIONINFOEXW contiene informazioni sulla versione del sistema operativo.

Sintassi

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

Members

dwOSVersionInfoSize

Dimensioni, in byte, di una struttura RTL_OSVERSIONINFOEXW . Questo membro deve essere impostato prima che venga usata la struttura con RtlGetVersion.

dwMajorVersion

Numero di versione principale del sistema operativo. Ad esempio, per Windows 2000, il numero di versione principale è cinque. Per altre informazioni, vedere la tabella in Osservazioni.

dwMinorVersion

Numero di versione secondaria del sistema operativo. Ad esempio, per Windows 2000, il numero di versione secondaria è zero. Per altre informazioni, vedere la tabella in Osservazioni.

dwBuildNumber

Numero di compilazione del sistema operativo.

dwPlatformId

Piattaforma del sistema operativo. Per Win32 nei sistemi operativi basati su NT, RtlGetVersion restituisce il valore VER_PLATFORM_WIN32_NT.

szCSDVersion[128]

Stringa di versione del Service Pack. Questo membro contiene una stringa con terminazione null, ad esempio "Service Pack 3", che indica l'ultimo Service Pack installato nel sistema. Se non è installato alcun service pack, RtlGetVersion potrebbe non inizializzare questa stringa. Inizializzare szCSDVersion su zero (stringa vuota) prima della chiamata a RtlGetVersion.

wServicePackMajor

Numero di versione principale del Service Pack più recente installato nel sistema. Ad esempio, per Service Pack 3, il numero di versione principale è tre. Se non è stato installato alcun Service Pack, il valore è zero.

wServicePackMinor

Numero di versione secondaria del Service Pack più recente installato nel sistema. Ad esempio, per Service Pack 3, il numero di versione secondaria è zero.

wSuiteMask

Le suite di prodotti disponibili nel sistema. Questo membro è impostato su zero o sull'OR bit per bit di uno o più dei valori seguenti.

Non è consigliabile basarsi esclusivamente sul flag VER_SUITE_SMALLBUSINESS per determinare se Small Business Server è attualmente installato. Sia questo flag che il flag VER_SUITE_SMALLBUSINESS_RESTRICTED vengono impostati quando questa suite di prodotti è installata. Se si aggiorna questa installazione a Windows Server, Standard Edition, il flag di VER_SUITE_SMALLBUSINESS_RESTRICTED viene cancellato, ma il flag di VER_SUITE_SMALLBUSINESS rimane impostato, che, in questo caso, indica che Small Business Server è stato installato in precedenza in questo sistema. Se questa installazione viene aggiornata ulteriormente a Windows Server, edizione Enterprise, il flag di VER_SUITE_SMALLBUSINESS rimane impostato.

wProductType

Tipo di prodotto. Questo membro contiene informazioni aggiuntive sul sistema. Questo membro può essere uno dei valori seguenti:

wReserved

Riservato per utilizzi futuri.

Commenti

Le informazioni contenute in questa struttura includono i numeri di versione principali e secondari, il numero di compilazione, l'identificatore della piattaforma, i pacchetti di prodotti installati e il Service Pack più recente installato nel sistema. Questa struttura viene usata con le routine RtlGetVersion e RtlVerifyVersionInfo .

L'uso delle informazioni sulla versione non è sempre il modo migliore per verificare se è disponibile una funzionalità. Per indicazioni, vedere la documentazione per la funzionalità a cui si è interessati.

Se possibile, progettare il codice di rilevamento della versione nel driver per abilitare l'esecuzione del driver nelle versioni future di Windows. Se il driver richiede una versione specifica del sistema operativo, assicurarsi di considerare questa versione come la versione minima supportata e non come l'unica versione in cui è possibile eseguire il driver.

La tabella seguente riepiloga le informazioni sulla versione restituite dalle versioni supportate di Windows. Usare le informazioni nella colonna "Altro" o nel numero di compilazione per distinguere tra i sistemi operativi con numeri di versione identici.

Solo un driver in modalità kernel a 64 bit può essere eseguito in Windows XP Professional x64 Edition. Pertanto, un driver in modalità kernel a 32 bit può omettere in modo sicuro il controllo di questa versione di Windows.

Requisiti

Vedi anche

RTL_OSVERSIONINFOW

RtlGetVersion

RtlVerifyVersionInfo