SetProcessAffinityUpdateMode-Funktion (processthreadsapi.h)
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.
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 |