Fonction AvRtDeleteThreadOrderingGroup (avrt.h)

Article
08/22/2023

Supprime le groupe de classement de threads spécifié créé par l’appelant. Il nettoie les ressources pour le groupe d’ordre des threads, y compris les informations de contexte, et retourne.

Syntaxe

AVRTAPI BOOL AvRtDeleteThreadOrderingGroup(
  [in] HANDLE Context
);

Paramètres

[in] Context

Handle de contexte. Ce handle est retourné par la fonction AvRtCreateThreadOrderingGroup lors de la création du groupe.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction ne peut être appelée correctement que par le thread parent pour le groupe de classement des threads. Si un thread autre que le thread parent appelle cette fonction, la fonction échoue avec un dernier code d’erreur de ERROR_INVALID_FUNCTION.

Si le thread parent expire et tente d’appeler cette fonction, la fonction échoue avec un dernier code d’erreur de ERROR_INVALID_PARAMETER.

Exemples

Le code suivant supprime un groupe de tri des threads.

#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;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	avrt.h
Bibliothèque	Avrt.lib
DLL	Avrt.dll

Voir aussi

Service de classement des threads

Partager via