SetProcessAffinityUpdateMode-Funktion (processthreadsapi.h)

  • Artikel

Legt den Affinitätsaktualisierungsmodus des angegebenen Prozesses fest.

Syntax

BOOL SetProcessAffinityUpdateMode(
  [in] HANDLE hProcess,
  [in] DWORD  dwFlags
);

Parameter

[in] hProcess

Ein Handle für den Prozess. Dieses Handle muss von der GetCurrentProcess-Funktion zurückgegeben werden.

[in] dwFlags

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

Wert Bedeutung
0
 Deaktiviert die dynamische Aktualisierung der Prozessaffinität durch das System.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE
0x000000001UL
 Ermöglicht eine dynamische Aktualisierung der Prozessaffinität durch das System.

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

Das System kann die Prozessaffinität unter verschiedenen Bedingungen anpassen, z. B. wenn ein Prozessor dynamisch hinzugefügt wird. Standardmäßig sind dynamische Updates für die Prozessaffinität für jeden Prozess deaktiviert.

Prozesse sollten diese Funktion verwenden, um anzugeben, ob sie die dynamische Anpassung der Prozessaffinität durch das System verarbeiten können. Nachdem ein Prozess den Affinitätsaktualisierungsmodus aktiviert hat, kann er diese Funktion aufrufen, um ihn zu deaktivieren. Ein Prozess kann den Affinitätsaktualisierungsmodus jedoch nicht aktivieren, nachdem er diese Funktion zum Deaktivieren verwendet hat.

Untergeordnete Prozesse erben nicht den Affinitätsaktualisierungsmodus des übergeordneten Prozesses. Der Affinitätsaktualisierungsmodus muss für jeden untergeordneten Prozess explizit festgelegt werden.

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ßlich Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

QueryProcessAffinityUpdateMode