Função RtlGetVersion

Obtém informações de versão sobre o sistema operacional em execução no momento.

Sintaxe

NTSTATUS RtlGetVersion(
  _Out_ PRTL_OSVERSIONINFOW lpVersionInformation
);

Parâmetros

lpVersionInformation [out]

Ponteiro para uma estrutura RTL_OSVERSIONINFOW ou uma estrutura RTL_OSVERSIONINFOEXW que contém as informações de versão sobre o sistema operacional em execução no momento. Um chamador especifica qual estrutura de entrada é usada definindo o membro dwOSVersionInfoSize da estrutura para o tamanho em bytes da estrutura usada.

Valor retornado

Retorna STATUS_SUCCESS.

Comentários

RtlGetVersion é o equivalente à função GetVersionEx no SDK do Windows. Consulte o exemplo no SDK do Windows que mostra como obter a versão do sistema.

Ao usar RtlGetVersion para determinar se uma versão específica do sistema operacional está em execução, um chamador deve marcar para números de versão maiores ou iguais ao número de versão necessário. Isso garante que um teste de versão seja bem-sucedido para versões posteriores do Windows.

Como os recursos do sistema operacional podem ser adicionados em uma DLL redistribuível, verificar apenas os números de versão principal e secundária não é a maneira mais confiável de verificar a presença de um recurso específico do sistema. Um driver deve usar RtlVerifyVersionInfo para testar a presença de um recurso específico do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de destino
Universal
Cabeçalho
Ntddk.h (inclua Ntddk.h)
Biblioteca
Ntdll.lib;
NtosKrnl.lib
DLL
Ntdll.dll;
NtosKrnl.exe

Confira também

PsGetVersion