SetUmsThreadInformation-Funktion (winbase.h)

  • Artikel

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