Compartilhar via


Função GetProcessVersion (processthreadsapi.h)

Recupera os números de versão principal e secundária do sistema no qual o processo especificado espera ser executado.

Sintaxe

DWORD GetProcessVersion(
  [in] DWORD ProcessId
);

Parâmetros

[in] ProcessId

O identificador de processo do processo de interesse. Um valor igual a zero especifica o processo de chamada.

Retornar valor

Se a função for bem-sucedida, o valor retornado será a versão do sistema na qual o processo espera ser executado. A palavra alta do valor retornado contém o número de versão principal. A palavra baixa do valor retornado contém o número de versão secundária.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. A função falhará se ProcessId for um valor inválido.

Comentários

A função GetProcessVersion é executada menos rapidamente quando ProcessId não é zero, especificando um processo diferente do processo de chamada.

O número de versão retornado por essa função é o número de versão carimbado no cabeçalho da imagem do arquivo .exe que o processo está em execução. Os programas vinculador definem esse valor.

Se essa função for chamada de um aplicativo de 32 bits em execução no WOW64, o processo especificado deverá ser um processo de 32 bits ou a função falhará.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de thread e processo

Processos