QueryProcessAffinityUpdateMode-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Ruft den Affinitätsupdatemodus des angegebenen Prozesses ab.

Syntax

BOOL QueryProcessAffinityUpdateMode(
  [in]            HANDLE  hProcess,
  [out, optional] LPDWORD lpdwFlags
);

Parameter

[in] hProcess

Ein Handle für den Prozess. Das Handle muss über das PROCESS_QUERY_INFORMATION- oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

[out, optional] lpdwFlags

Der Affinitätsaktualisierungsmodus. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
0	Die dynamische Aktualisierung der Prozessaffinität durch das System ist deaktiviert.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE 0x000000001UL	Die dynamische Aktualisierung der Prozessaffinität durch das System ist aktiviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion aufruft, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (einschließen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

SetProcessAffinityUpdateMode

Freigeben über