QueryProcessAffinityUpdateMode-Funktion (processthreadsapi.h)

  • Artikel

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