AvRtDeleteThreadOrderingGroup-Funktion (avrt.h)

  • Artikel

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

Weitere Informationen

Threadreihenfolgedienst