AvRtJoinThreadOrderingGroup-Funktion (avrt.h)

Verknüpft Clientthreads mit einer Threadreihenfolgegruppe.

Syntax

AVRTAPI BOOL AvRtJoinThreadOrderingGroup(
  [out] PHANDLE Context,
  [in]  GUID    *ThreadOrderingGuid,
  [in]  BOOL    Before
);

Parameter

[out] Context

Ein Zeiger auf ein Kontexthandle.

[in] ThreadOrderingGuid

Ein Zeiger auf den eindeutigen Bezeichner für die Threadreihenfolgegruppe.

[in] Before

Die Threadreihenfolge. Wenn dieser Parameter TRUE ist, ist der Thread ein Vorgängerthread, der vor dem übergeordneten Thread ausgeführt werden soll. Wenn dieser Parameter FALSE ist, ist der Thread ein Nachfolgerthread, der nach dem übergeordneten Thread ausgeführt werden soll.

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

Der Thread schließt den Code, der während jedes Zeitraums ausgeführt werden soll, in eine Schleife ein, die von der AvRtWaitOnThreadOrderingGroup-Funktion gesteuert wird.

Ein Thread kann mehr als eine Threadreihenfolgegruppe erstellen und mehrere Threadreihenfolgegruppen verknüpfen. Ein Thread kann jedoch nicht mehr als einmal derselben Threadreihenfolgegruppe beitreten.

Die Anzahl der Threads, die einer Gruppe beitreten können, ist nur durch verfügbare Systemressourcen begrenzt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	avrt.h
Bibliothek	Avrt.lib
DLL	Avrt.dll

Weitere Informationen

Threadreihenfolgedienst