Freigeben über


SetProcessDynamicEnforcedCetCompatibleRanges-Funktion (processthreadsapi.h)

Hinweis

Diese API wurde dem SDK 19041 in einem Update hinzugefügt, das im November 2020 veröffentlicht wurde.

Legt dynamisch erzwungene CETCOMPAT-Bereiche für den angegebenen Prozess fest.

Syntax

BOOL SetProcessDynamicEnforcedCetCompatibleRanges(
  HANDLE                                  Process,
  USHORT                                  NumberOfRanges,
  PPROCESS_DYNAMIC_ENFORCED_ADDRESS_RANGE Ranges
);

Parameter

Process

Ein Handle für den Prozess. Dieses Handle muss über das zugriffsrecht PROCESS_SET_INFORMATION verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

NumberOfRanges

Gibt die Anzahl der festzulegenden dynamisch erzwungenen CETCOMPAT-Bereiche an.

Ranges

Ein Zeiger auf ein Array von dynamisch erzwungenen CETCOMPAT-Bereichen. Weitere Informationen zu dieser Struktur finden Sie unter PROCESS_DYNAMIC_ENFORCED_ADDRESS_RANGE.

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. Beachten Sie, dass selbst wenn die Funktion fehlschlägt, ein Teil der angegebenen CETCOMPAT-Bereiche möglicherweise erfolgreich verarbeitet wurde. Der Aufrufer muss die Flags in jedem einzelnen CETCOMPAT-Bereich überprüfen, der über Ranges angegeben ist, um festzustellen, ob er erfolgreich verarbeitet wurde.

Hinweise

Der Hardware-erzwungene Stapelschutz (HSP) des Benutzermodus ist ein Sicherheitsfeature, bei dem die CPU die Funktionsrückgabeadressen zur Laufzeit überprüft, indem sie einen Schattenstapelmechanismus verwendet, sofern dies von der Hardware unterstützt wird. Im HSP-Kompatibilitätsmodus sind nur Schattenstapelverletzungen, die in Modulen auftreten, die als kompatibel mit Schattenstapeln (CETCOMPAT) gelten, schwerwiegend. Damit ein Modul als CETCOMPAT gilt, muss es entweder mit CETCOMPAT für Binärdateien kompiliert oder mit SetProcessDynamicEnforcedCetCompatibleRanges für dynamischen Code markiert werden. Im strengen HSP-Modus sind alle Verstöße gegen Schattenstapel fatal.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004 (10.0; Build 19041.662)
Unterstützte Mindestversion (Server) Windows Server, Version 2004 (10.0; Build 19041.662)
Kopfzeile processthreadsapi.h