Função RtlGetVersion (wdm.h)

A rotina RtlGetVersion retorna informações de versão sobre o sistema operacional em execução no momento.

Sintaxe

NTSYSAPI NTSTATUS RtlGetVersion(
  [out] PRTL_OSVERSIONINFOW lpVersionInformation
);

Parâmetros

[out] lpVersionInformation

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.

Retornar valor

RtlGetVersion retorna STATUS_SUCCESS.

Comentários

RtlGetVersion é o equivalente ao modo kernel da função GetVersionEx no modo de usuário no SDK do Windows. Confira 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	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (inclua Ntddk.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

PsGetVersion