AvRtDeleteThreadOrderingGroup-Funktion (avrt.h)
Löscht die angegebene Threadreihenfolgegruppe, die vom Aufrufer erstellt wurde. Es bereinigt Ressourcen für die Threadreihenfolgegruppe, einschließlich der Kontextinformationen, und gibt zurück.
Syntax
AVRTAPI BOOL AvRtDeleteThreadOrderingGroup(
[in] HANDLE Context
);
Parameter
[in] Context
Ein Kontexthandle. Dieses Handle wird von der AvRtCreateThreadOrderingGroup-Funktion beim Erstellen der Gruppe zurückgegeben.
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
Diese Funktion kann nur vom übergeordneten Thread für die Threadreihenfolgegruppe erfolgreich aufgerufen werden. Wenn ein anderer Thread als der übergeordnete Thread diese Funktion aufruft, schlägt die Funktion mit dem letzten Fehlercode ERROR_INVALID_FUNCTION fehl.
Wenn für den übergeordneten Thread ein Timeout auftritt und versucht, diese Funktion aufzurufen, schlägt die Funktion mit dem letzten Fehlercode ERROR_INVALID_PARAMETER fehl.
Beispiele
Der folgende Code löscht eine Threadreihenfolgegruppe.
#include <windows.h>
#include <avrt.h>
#include <stdio.h>
#pragma comment(lib, "Avrt.lib")
HANDLE Context;
int main( void )
{
if(!AvRtDeleteThreadOrderingGroup(Context))
{
printf("Error deleting group (%d)\n", GetLastError());
return 1;
}
return 0;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |