SetUmsThreadInformation-Funktion (winbase.h)

Artikel
03/08/2023

Legt anwendungsspezifische Kontextinformationen für den angegebenen UmS-Workerthread (Benutzermodusplanung) fest.

Warnung

Ab Windows 11 wird die Planung im Benutzermodus nicht unterstützt. Alle Aufrufe schlagen mit dem Fehler ERROR_NOT_SUPPORTEDfehl.

Syntax

BOOL SetUmsThreadInformation(
  [in] PUMS_CONTEXT          UmsThread,
  [in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [in] PVOID                 UmsThreadInformation,
  [in] ULONG                 UmsThreadInformationLength
);

Parameter

[in] UmsThread

Ein Zeiger auf einen UMS-Threadkontext.

[in] UmsThreadInfoClass

Ein UMS_THREAD_INFO_CLASS Wert, der die Art der festzulegenden Informationen angibt. Dieser Parameter muss UmsThreadUserContext sein.

[in] UmsThreadInformation

Ein Zeiger auf einen Puffer, der die festzulegenden Informationen enthält.

[in] UmsThreadInformationLength

Die Größe des UmsThreadInformation-Puffers in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie einen Wert ohne Zero zurück.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
ERROR_INFO_LENGTH_MISMATCH	Die Puffergröße entspricht nicht der erforderlichen Größe für die angegebene Informationsklasse.
ERROR_INVALID_INFO_CLASS	Der Parameter UmsThreadInfoClass gibt eine Informationsklasse an, die nicht unterstützt wird.
ERROR_NOT_SUPPORTED	UMS wird nicht unterstützt.

Bemerkungen

Mit der SetUmsThreadInformation-Funktion kann ein anwendungsdefinierter Kontext für den angegebenen UMS-Workerthread festgelegt werden. Die Kontextinformationen können aus allem bestehen, was die Anwendung für die Nachverfolgung nützlich finden könnte, z. B. pro Planer oder pro Workerthreadstatus. Die zugrunde liegenden Strukturen für UMS-Workerthreads werden vom System verwaltet und sollten nicht direkt geändert werden.

Die QueryUmsThreadInformation-Funktion kann verwendet werden, um andere verfügbar gemachte Informationen zum angegebenen Thread abzurufen, z. B. seinen Threadausführungsblock (TEB) und ob der Thread angehalten oder beendet wird. Informationen, die nicht über QueryUmsThreadInformation verfügbar gemacht werden, sollten als reserviert betrachtet werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 (nur 64-Bit) [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll
APIs	api-ms-win-core-ums-l1-1-0 (in Windows 7 eingeführt)

Siehe auch

QueryUmsThreadInformation

Freigeben über