Freigeben über


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

Siehe auch

Prozess- und Threadfunktionen

Prozesse