Share via


GetProcessVersion, fonction (processthreadsapi.h)

Récupère les numéros de version principale et secondaire du système sur lequel le processus spécifié s’attend à s’exécuter.

Syntaxe

DWORD GetProcessVersion(
  [in] DWORD ProcessId
);

Paramètres

[in] ProcessId

Identificateur de processus du processus d’intérêt. La valeur zéro spécifie le processus appelant.

Valeur retournée

Si la fonction réussit, la valeur de retour est la version du système sur laquelle le processus s’attend à s’exécuter. Le mot haut de la valeur de retour contient le numéro de version principale. Le mot bas de la valeur de retour contient le numéro de version secondaire.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. La fonction échoue si ProcessId n’est pas une valeur non valide.

Remarques

La fonction GetProcessVersion s’exécute moins rapidement lorsque ProcessId est différent de zéro, en spécifiant un processus autre que le processus appelant.

Le numéro de version retourné par cette fonction est le numéro de version estampillé dans l’en-tête d’image du fichier .exe le processus est en cours d’exécution. Les programmes éditeur de liens définissent cette valeur.

Si cette fonction est appelée à partir d’une application 32 bits s’exécutant sur WOW64, le processus spécifié doit être un processus 32 bits ou la fonction échoue.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête processthreadsapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

Fonctions de processus et de thread

Processus