GetProcessVersion-Funktion (processthreadsapi.h)
Ruft die Haupt- und Nebenversionsnummern des Systems ab, auf dem der angegebene Prozess ausgeführt werden soll.
Syntax
DWORD GetProcessVersion(
[in] DWORD ProcessId
);
Parameter
[in] ProcessId
Der Prozessbezeichner des relevanten Prozesses. Der Wert 0 (null) gibt den aufrufenden Prozess an.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Version des Systems, auf dem der Prozess ausgeführt werden soll. Das hohe Wort des Rückgabewerts enthält die Hauptversionsnummer. Das niedrige Wort des Rückgabewerts enthält die Nebenversionsnummer.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die Funktion schlägt fehl, wenn ProcessId ein ungültiger Wert ist.
Hinweise
Die GetProcessVersion-Funktion funktioniert weniger schnell, wenn ProcessId ungleich null ist, und gibt einen anderen Prozess als den aufrufenden Prozess an.
Die von dieser Funktion zurückgegebene Versionsnummer ist die Versionsnummer, die im Imageheader der .exe-Datei gestempelt ist, die der Prozess ausführt. Linkerprogramme legen diesen Wert fest.
Wenn diese Funktion von einer 32-Bit-Anwendung aufgerufen wird, die auf WOW64 ausgeführt wird, muss der angegebene Prozess ein 32-Bit-Prozess sein, andernfalls schlägt die Funktion fehl.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | processthreadsapi.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |